VSCode调试Python前必须确认三件事：安装官方Python扩展、工作区含可识别Python文件并已选对解释器、当前文件含顶层执行语句；再手动配置launch.json、设断点、用Variables和Watch面板查变量。
VSCode调试Python前必须确认的三件事
不能直接开调，否则断点不生效、变量全灰色、launch.json报错——先检查这三项：
- 已安装官方
Python扩展（不是Pylance或Python Test Explorer单独扩展） - 工作区根目录下有可识别的 Python 文件（如
main.py），且 VSCode 已正确识别解释器：按Ctrl+Shift+P→ 输入Python: Select Interpreter→ 选中带路径的环境（如/usr/bin/python3或venv/Scripts/python.exe） - 当前文件不是纯模块（比如只有
def foo(): ...没有if __name__ == "__main__":或顶层执行语句），否则调试启动后立刻退出
配置 launch.json 并设置断点的最小可行步骤
VSCode 不会自动创建调试配置，必须手动初始化；很多问题其实卡在这一步。
- 打开要调试的
.py文件，点击左侧活动栏的「调试图标」→ 点击顶部的「创建 launch.json 文件」→ 选择环境为Python→ 选Python File - 生成的
launch.json中确保"module"字段未被误启用（除非你真在调试python -m xxx），默认应使用"program": "${file}" - 在代码行号左侧单击设断点（红点），注意：灰色圆点 = 断点未激活（常见于路径错误或解释器未识别），实心红点 = 就绪
- 按
F5启动调试；若弹出「No configuration」提示，说明.vscode/launch.json根本没生成或不在当前工作区根目录
变量监控：局部变量/全局变量/watch表达式怎么用
调试时变量面板默认只显示当前作用域的局部变量，很多值根本看不到。
- 「变量（Variables）」面板里展开
Locals看函数内变量，Globals看模块级变量；但类实例属性、嵌套字典键值需手动点开 - 右键变量 → 「Add to Watch」可把任意表达式加入监视（如
len(my_list)、user.profile.name），支持实时求值 - Watch 面板里双击表达式可编辑，比如把
data改成data[:10]查看前10项；注意：含副作用的表达式（如queue.get()）每次刷新都会执行 - 如果变量显示
[Object]或[Array]点不开，说明是复杂对象（如 Pandas DataFrame），此时右键 → 「View Value in Interactive Window」更可靠
常见断点失效和变量空白的真正原因
不是插件坏了，大概率是路径或运行上下文不对。
立即学习“Python免费学习笔记（深入）”；
- 断点变空心灰点：VSCode 当前工作区路径 ≠ Python 解释器实际运行路径；解决方法：用
os.getcwd()打印当前目录，对比launch.json中"cwd"配置是否匹配 - 变量面板全空或只显示
import main），而非直接运行；确保调试的是入口文件，且launch.json的"program"指向它 - 修改代码后断点跳到旧行：Python 缓存了
.pyc文件；删掉项目下的__pycache__目录再试 - 异步代码（
async def）变量无法实时更新：需在await行设断点，不要在协程定义处设；且确认launch.json中"justMyCode"设为true，避免跳进 asyncio 内部
变量监控真正难的不是操作，而是理解当前调试帧的作用域边界——尤其在装饰器、闭包、多线程场景下，同一变量名可能指向完全不同的对象实例。
