返回课程总览

实验 01 · 工具准备

安装与账号

安装 VS Code、Python、Git、MATLAB 与 OpenCode，并在 PowerShell 中逐项验证。

完整讲义

实验 1：安装与账号

目标

安装或确认课程需要的工具：VS Code、Python、Git、MATLAB 和 OpenCode。本实验关注 环境准备，不进入正式编程。

必需工具

  • Windows PowerShell
  • VS Code
  • Python
  • Git for Windows
  • MATLAB
  • Node.js LTS 与 npm
  • OpenCode
小知识：PowerShell 是做什么的？

PowerShell 同时包含命令行环境和脚本语言。手动输入 mkdir 是在完成一次操作； 把一系列命令保存成脚本，则可以让计算机按相同步骤重复执行。系统管理员常用它管理 Windows，开发者也用它构建、测试和部署程序。它的价值不在于窗口看起来专业，而在于 操作可以被记录、检查和自动化。Microsoft 的概览 还介绍了 PowerShell 如何在命令之间传递结构化对象。

打开 PowerShell

后面的验证命令都需要在 PowerShell 中输入。

  1. 按 Windows 键。
  2. 输入 PowerShell。
  3. 在搜索结果中选择 Windows PowerShell。

窗口中会显示类似 PS C:\Users\你的用户名> 的文字。这是提示符，表示 PowerShell 正在等待命令；不要输入提示符，只输入每个代码块中的命令。

小知识：PS C:\...> 告诉了你什么？

提示符不是固定装饰。PS 表示当前环境是 PowerShell，C:\... 显示当前工作位置， 最后的 > 表示它已经准备好接收下一条命令。执行 cd 后路径会变化，因此提示符也是 检查“我现在在哪里”的快速线索。PowerShell 甚至允许用户修改提示符，不过本课程保留 默认形式，避免把界面定制和真正要运行的命令混在一起。

程序、命令与 PATH

VS Code、Python、Git 和 OpenCode 安装后，都会在磁盘上留下可以运行的可执行程序。在 PowerShell 中输入 python 或 git，输入的是命令名称，不是程序的完整文件路径。 PowerShell 不会搜索整块磁盘，而会在系统已经登记的位置中寻找对应程序。

PATH 是一组目录，PowerShell 会按顺序在这些目录中查找外部命令。例如 VS Code 安装器的 Add to PATH 选项，就是把 code 所在目录加入这组搜索位置。软件可能已经能从开始菜单 打开，但如果它的目录不在 PATH 中，PowerShell 仍会报告无法识别命令。

安装器修改 PATH 后，已经打开的 PowerShell 窗口可能仍保留旧信息。因此讲义会多次要求 关闭并重新打开 PowerShell，让新窗口读取更新后的命令搜索目录。

课程还会用到三类安装管理工具：

工具 管理范围 本课程中的作用
winget Windows 应用 安装 Git for Windows 等应用
Python Install Manager Python 运行时 安装和选择实际执行 .py 文件的 Python
npm Node.js 命令行程序 安装和更新 OpenCode

安装管理工具负责取得、安装或更新软件；真正编辑和计算的仍是 VS Code、Python、Git、MATLAB 和 OpenCode 等实际程序。后面每次运行 --version，都是在验证 PowerShell 已经找到对应程序。

安装 VS Code

  1. 打开 VS Code 官方下载页面：
https://code.visualstudio.com/Download
  1. 下载 Windows 安装程序。
  2. 运行安装程序。
  3. 保留默认选项。如果看到 Add to PATH，请勾选。
  4. 关闭并重新打开 PowerShell。
  5. 验证：
code --version

如果无法识别 code，今天可以先从开始菜单打开 VS Code。之后根据 VS Code 安装文档检查 PATH 设置。

安装或确认 Python

  1. 先检查 Python 是否已经安装：
python --version
  1. 如果缺少 Python，打开 Python 官方 Windows 下载页面：
https://www.python.org/downloads/windows/
  1. 下载并运行 Python Install Manager。它负责安装和管理具体的 Python 运行时。
  2. 关闭并重新打开 PowerShell。
  3. 安装当前默认的稳定版 Python：
py install
  1. 验证：
python --version
  1. 确认 Python 可以运行一个简单命令：
python -c "print('hello from Python')"

如果仍然无法识别 python，请重新检查 Python 是否已加入 PATH。 在 Python 能从 PowerShell 运行之前，不要继续实验 2。

Python Install Manager 和 Python 运行时不是同一个程序：前者负责安装、更新和选择版本， 后者负责执行 .py 文件。课程只使用刚刚安装的默认稳定版，不需要同时维护多个版本。

安装或确认 Git

Git 会记录项目文件随时间发生的变化。后面的 git diff 检查和阶段性提交都依赖它。

  1. 先检查 Git 是否已经安装：
git --version
  1. 如果 PowerShell 无法识别 git，运行 Windows 包管理器命令安装 Git for Windows：
winget install --id Git.Git -e
  1. 安装结束后关闭并重新打开 PowerShell，再次验证：
git --version

本课程只使用 Git 管理本机文件。实验 2 会创建本地 Git 仓库，不需要把代码公开到网络。

确认 MATLAB

运行：

matlab

MATLAB 可能会作为单独应用打开。确认能启动后可以关闭。

安装 Node.js LTS 与 OpenCode

OpenCode 通过 npm 安装。npm 随 Node.js 一起提供，所以先安装长期支持版 Node.js LTS。本课程只使用 Windows 原生 PowerShell，不使用 WSL 或 Git Bash。 OpenCode 官网展示的一行 curl 安装方式需要 Bash，不能直接作为 PowerShell 命令使用。

  1. 用 Windows 包管理器安装 Node.js LTS：
winget install --id OpenJS.NodeJS.LTS -e --source winget
  1. 安装完成后关闭并重新打开 PowerShell。
  2. 分别确认 Node.js 和 npm 已进入 PATH：
node --version
npm --version
  1. 使用 npm 安装 OpenCode：
npm install -g opencode-ai
  1. 验证 OpenCode：
opencode --version

如果无法识别 node、npm 或 opencode，先关闭并重新打开 PowerShell，再检查上一条安装 命令是否成功。课程使用 npm 安装路径，避免手动解压可执行文件和维护 PATH。

连接 OpenCode Go

OpenCode 是 coding agent；OpenCode Go 是本课程使用的模型提供商。OpenCode Go 是付费服务， 具体价格可能变化，订阅前请查看官方说明中的当前信息。本课程 统一使用 DeepSeek V4 Pro，它在 OpenCode 中的完整模型标识是 opencode-go/deepseek-v4-pro。

  1. 从 PowerShell 启动 OpenCode：
opencode
  1. 在 OpenCode 中输入：
/connect
  1. 选择 OpenCode Go，按界面提示登录、订阅并创建 API Key。
  2. 回到 OpenCode，粘贴 API Key 完成连接。
  3. 输入：
/models
  1. 选择 DeepSeek V4 Pro，并确认模型标识为

opencode-go/deepseek-v4-pro。

  1. 输入 /exit 返回 PowerShell。

API Key 相当于访问凭据，不得写入截图、实验笔记、提示词文件或 Git，也不要发给其他人。 /connect 负责连接提供商，/models 负责选择模型；完成连接不等于已经选中课程模型。

Checkpoint

完成后确认：

  • code --version 可用，或 VS Code 能从开始菜单打开。
  • python --version 可用。
  • python -c "print('hello from Python')" 可用。
  • git --version 可用。
  • MATLAB 能启动。
  • node --version 和 npm --version 可用。
  • opencode --version 可用，OpenCode Go 已连接。
  • /models 中已选择 DeepSeek V4 Pro。

完成内容

  • 显示 VS Code 已安装的截图。
  • 显示 Python 版本的截图。
  • 显示 Git 版本的截图。
  • 显示 Python hello 命令的截图。
  • OpenCode 版本、OpenCode Go 连接完成和模型选择记录。截图不得显示 API Key。

反思问题

简短回答：

  1. 哪些工具已经安装好了？
  2. 今天哪个工具需要设置？
  3. 哪个命令可以检查 VS Code 是否能从 PowerShell 使用？
  4. Python Install Manager 和 Python 运行时分别做什么？
  5. 为什么安装程序结束后通常要重新打开 PowerShell？
  6. 哪两个命令分别验证 Git 和 OpenCode 已经安装？
  7. /connect 和 /models 分别负责什么？