VSCode调试Python需正确配置Python解释器和launch.json：先通过命令选择带明确路径的解释器，再在launch.json中设置cwd、env和console字段，确保断点生效、变量可见、输入不卡死。
VSCode 调试 Python 不需要装一堆插件也能跑起来，但默认配置下容易卡在断点不触发、变量看不到、print 和调试器不同步——核心问题通常是 launch.json 配置错位或 Python 解释器没绑定对。
确认 Python 解释器路径是否被正确识别
调试失败的头号原因：VSCode 用的不是你预期的 Python 环境。比如你在终端里 pip install requests 了，但 VSCode 调试时却报 ModuleNotFoundError。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，从列表里选中带明确路径的选项（如./venv/bin/python或C:\myproject\env\Scripts\python.exe） - 别选 “System Python” 或 “Python 3.x” 这类模糊名称，它们可能指向系统级 Python，和你的项目虚拟环境无关
- 选完后看窗口右下角状态栏，应显示类似
Python 3.11.5 ('venv': venv)的完整标识
launch.json 中最常配错的三个字段
自动生成的 launch.json 往往只填了 module 或 file，但漏掉关键上下文，导致断点失效或工作目录错误。
-
"cwd"必须显式设置：它决定程序启动时的当前目录，影响相对路径读取（如open("data.csv")）。不设就默认是打开 VSCode 时的根目录，而非脚本所在目录 -
"env"要手动补全：如果代码依赖环境变量（如os.getenv("API_KEY")），必须在这里写进去，调试器不会继承终端的环境 -
"console"推荐设为"integratedTerminal"：用内建终端而非internalConsole，否则input()会卡死、异步日志可能乱序
示例最小可用配置：
立即学习“Python免费学习笔记（深入）”；
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"module": "myapp.main",
"cwd": "${fileDirname}",
"env": { "DEBUG": "1", "PYTHONPATH": "${workspaceFolder}" },
"console": "integratedTerminal"
}
]
}
断点不命中？检查这三件事
打了断点却直接跑过、变量窗空白、调用栈显示 <unknown>——多数不是代码问题，而是调试器没真正 attach 上。
- 确保文件已保存：
launch.json启动的是磁盘上实际存在的 .py 文件，未保存的修改不会生效 - 检查是否在生成的
.pyc或__pycache__文件里下了断点：VSCode 有时会误开缓存文件，地址栏显示路径含__pycache__就立刻关掉 - 禁用“仅 my code”模式：在调试面板顶部点击齿轮图标 → 取消勾选
Just My Code，否则跳进第三方库（如requests.get()）时会直接跳过
调试时快速查看变量值的冷技巧
不用总盯着“变量”窗拖滚动条，效率低还容易漏。
- 把鼠标悬停在任意变量名上，秒出值（支持嵌套结构体，如
user.profile.name） - 在“调试控制台”里直接输表达式：比如
len(data)、response.json().keys()，回车即得结果，等效于在 pdb 里敲p - 右键变量 →
Copy Value，粘贴到笔记或测试脚本里复现问题，比截图快得多
复杂对象（比如 pandas DataFrame 或自定义类实例）展开慢，首次点击后会缓存，但若字段太多仍会卡顿——这时优先用调试控制台执行 df.head().to_dict() 拿精简数据。
