【第4期】VS Code 从工作区到调试：把“能写代码”变成“能定位问题”

系列：《从小白到 AI 大模型开发工程师的进阶之路》
技术点：AI-0004 VS Code 使用
主人公：小蓝伞

VS Code 不只是一个文本框

小蓝伞第一次打开 VS Code 时，把它当成“更漂亮的记事本”。等项目多起来，他发现真正重要的是工作区、集成终端、扩展、格式化和调试器之间的关系。本期做一个最小 Python 项目，理解这些部件如何协作。

工作区是什么

VS Code 工作区是当前窗口打开的一个或多个文件夹。它可以保存项目级设置、任务、调试配置和扩展建议。单文件夹设置通常放在 .vscode/settings.json，多根工作区可以保存为 .code-workspace 文件。打开项目根目录，而不是只打开某个 .py 文件，后续路径和调试才更可解释。

建立最小项目

New-Item -ItemType Directory -Force .\vscode-demo | Out-Null
Set-Location .\vscode-demo
New-Item main.py -ItemType File
code .

如果 code 命令不可用，先从 VS Code 菜单打开文件夹，不要把“命令不存在”误判成项目代码错误。

集成终端

通过“视图 > 终端”或 Ctrl+`` 打开。终端通常从工作区根目录启动，可以在 PowerShell、CMD 等 Shell 之间切换。小蓝伞的经验是：每次运行前先执行Get-Location`，路径问题就少了一半。

扩展与格式化

扩展改变的是编辑器能力，不等于项目依赖。Python 项目通常需要 Python 扩展和一个明确的解释器；格式化工具应通过项目设置固定规则。可在 .vscode/settings.json 中记录 editor.formatOnSave，但不要在不了解项目规范时强行改格式。

{
  "editor.formatOnSave": true
}

保存前先确认格式化器来源，避免团队成员使用不同工具产生无意义 diff。

调试和断点

在代码左侧边距点击或按 F9 设置断点，打开 Run and Debug 面板启动调试。简单脚本可以直接运行；复杂项目应使用 .vscode/launch.json 明确程序入口、参数、工作目录和环境变量。断点的价值不是“停住”，而是观察变量、调用栈和实际执行路径。

最小验证

main.py 写入：

def add(a, b):
    return a + b

print(add(2, 3))

运行并确认输出 5，再在 return 行设置断点，观察 a、b。这一步属于最小实践，不要把看到编辑器打开当成调试成功。

面试题

1. 工作区与单个文件有什么区别？工作区保存项目级设置、任务、调试和扩展状态。
2. VS Code 集成终端是什么？它是嵌入编辑器的终端界面，实际命令仍由所选 Shell 解释。
3. 为什么断点不生效？可能没有使用调试启动、入口不对、代码路径未执行或扩展不匹配。
4. formatOnSave 有什么风险？不同格式化器或规则会造成代码风格漂移。

官方资料：VS Code 工作区、集成终端、调试、基础编辑。下一期 AI-0005 进入 PyCharm。关注“伞伞悦读”，让小蓝伞把每一次报错都变成证据。