VS Code需安装ms-python.python扩展并正确配置虚拟环境解释器路径，手动编辑launch.json设置args/module等调试参数，善用条件断点和Debug Console，启用Pylance并安装类型存根包以修复补全与提示问题。
安装 Python 扩展和配置解释器路径
VS Code 本身不内置 Python 支持，必须通过 Python 扩展（由 Microsoft 提供）启用语法高亮、智能提示、调试入口等功能。安装后若 Ctrl+Shift+P 输入 Python: Select Interpreter 没反应，大概率是没装对扩展——确认名称是 ms-python.python，不是第三方“Python for VS Code”之类。
选解释器时，优先用虚拟环境的 python 可执行文件路径（如 ./venv/bin/python 或 .\venv\Scripts\python.exe），而非系统全局 Python。否则 import 报错、包补全失效、调试时断点不命中等问题会反复出现。
- Windows 用户注意：PowerShell 默认禁用脚本执行，首次激活虚拟环境可能报错
execution policies，临时改用 CMD 或运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - Mac/Linux 用户若用
pyenv，确保pyenv shell 3.11.5已生效后再选解释器，否则 VS Code 读到的是系统默认 Python - 解释器路径一旦选错，
.vscode/settings.json里会多出"python.defaultInterpreterPath"字段，删掉并重新选择更稳妥
用 launch.json 配置调试参数而不是靠 F5 盲调
直接按 F5 启动调试，VS Code 会尝试自动生成 .vscode/launch.json，但默认配置常忽略关键参数，导致无法传参、无法进子模块、或工作目录错误。真实项目中几乎都需要手动编辑该文件。
比如调试一个带命令行参数的脚本 main.py --input data.csv --verbose，必须在 launch.json 的对应配置里加 "args" 字段：
立即学习“Python免费学习笔记（深入）”；
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"module": "myapp.cli",
"args": ["--input", "data.csv", "--verbose"],
"console": "integratedTerminal",
"justMyCode": true
}
]
}
-
"module"比"program"更适合包结构项目（如python -m myapp.cli），避免ImportError -
"console": "integratedTerminal"能看到完整输出和交互输入，"internalConsole"在某些版本里不支持input() -
"justMyCode": true是默认值，但显式写出可防止被 workspace 设置覆盖，避免意外进入三方库源码
调试时变量查看和条件断点的实际用法
光打普通断点不够。复杂逻辑中，需要快速确认某变量是否为 None、某列表长度是否突变、或某函数只在特定条件下中断——这些靠“运行到断点 → 看变量 → 继续 → 再打断点”效率极低。
右键断点可设 条件（Condition）或 命中次数（Hit Count）。例如在循环内只想看第 100 次迭代：
- 条件断点填
i == 99（注意 Python 索引从 0 开始） - 命中次数填
100，等同于“暂停前跳过前 99 次” - 变量监视栏（Watch）里可输表达式，如
len(my_list)、response.status_code，不必展开对象树找字段 - 调试中鼠标悬停变量名能显示值，但对嵌套深或大对象不友好；用
Debug Console输入pprint.pprint(data)更清晰
代码补全失效或类型提示不准的常见修复路径
即使装了扩展、选了正确解释器，str. 补全不出 removeprefix，或 pd.DataFrame 提示缺失方法，通常不是扩展 bug，而是类型信息没加载进来。
- 检查是否启用了
Pylance（Python 扩展依赖的默认语言服务器），在设置里搜python.languageServer，值应为Pylance，不是Jedi - 第三方库如
pandas、requests若有py.typed文件（现代包标配），Pylance 自动识别；若用旧版或本地开发包，需在pyrightconfig.json中加"extraPaths" - 类型存根缺失时，手动安装
pip install types-requests等 stub 包，比关掉类型检查更治本 - 重启 Pylance：命令面板输入
Developer: Restart Language Server，比重启 VS Code 快得多
调试和补全看似是两个功能，实际共享同一套语言服务状态。解释器路径错、Pylance 挂起、stub 包缺失，三者任一出问题，都会同时影响断点行为和代码提示。别分开排查。
