VSCode调试Python断点不生效等问题根源在于启动方式和配置错误，而非代码本身；需正确选择解释器、合理配置launch.json、关闭Just My Code、注意工作目录与PYTHONPATH，并善用Debug Console定位问题。
VSCode 调试 Python 不需要装一堆插件也能跑起来，但默认配置下断点不生效、变量看不到、print 和调试器不同步——问题往往出在启动方式和配置没对上，而不是代码本身。
确认 Python 扩展和解释器已正确绑定
很多人点了“开始调试”却进不了断点，第一反应是“插件坏了”，其实只是 VSCode 没选对 Python 解释器。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，选中你项目实际使用的环境（比如./venv/bin/python或conda env路径） - 检查右下角状态栏：必须显示类似
Python 3.11.5 64-bit ('venv': venv)，否则launch.json里写的python可能指向系统全局 Python，导致包找不到、路径错乱 - 如果用 Poetry 或 Pipenv，别手动选解释器路径，先运行
poetry shell或pipenv shell，再在已激活的终端里打开 VSCode（code .），否则调试器无法识别依赖
用 launch.json 配置比直接点绿色箭头更可靠
点击编辑器左上角的绿色三角形（“运行 Python 文件”）本质是调用 python file.py，不走调试器逻辑，断点、环境变量、工作目录都不可控。
- 按
Ctrl+Shift+D打开调试面板 → 点“创建 launch.json 文件” → 选Python File - 生成的配置里确保
"module": "runpy"不要删——它让调试器支持-m方式运行模块，避免ImportError；若调试的是包内模块（如myproject.cli），改用"module": "myproject.cli" - 常用改项：
"env": {"PYTHONPATH": "${workspaceFolder}"}解决相对导入失败；"cwd": "${fileDirname}"让当前工作目录匹配文件所在目录，防止open("data.txt")找不到文件
调试时变量不更新？检查“仅 my code”和“异步堆栈”开关
明明打了断点，但 Variables 面板里全是
立即学习“Python免费学习笔记（深入）”；
- 调试过程中，点击调试工具栏右侧的齿轮图标 → 取消勾选
Just My Code（VSCode 1.85+ 默认开启）：否则第三方库、__init__.py、甚至你自己写的from .utils import *都会被跳过，变量不展开 - 如果代码含
async/await，在调试面板顶部点⋯ → Toggle All Async Stack Trace，否则 await 后的变量可能显示为pending或直接消失 - 鼠标悬停看变量值失效？不是 bug——它只读取当前作用域。想查嵌套字典某一层，直接在
Debug Console里输data['items'][0]['id']回车，比展开三层树快得多
快速定位报错位置：别只看终端红色文字
终端里一长串 traceback 很吓人，但真正有用的只有最后一行（实际抛错点）和倒数第三行（调用源头）。VSCode 可以直接跳过去。
- 终端报错后，立刻按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools，切到Console标签页，点红色错误行，会自动跳转到对应源码位置（比肉眼扫 traceback 快） - 如果错在第三方库（比如
requests报ConnectionError），在Breakpoints面板勾选Caught Exceptions→Python Exceptions，再复现一次，调试器会在异常抛出前就中断，你能看到完整的请求参数和 headers - 遇到
UnicodeDecodeError这类编码错，别急着重启——在Debug Console里执行import locale; locale.getpreferredencoding()，对比文件实际编码，再加open(... , encoding='utf-8')
最常被忽略的其实是工作目录和 PythonPath 的隐式差异：你在终端里 cd src && python main.py 能跑，不代表调试器也从 src 启动。每次改完 launch.json 记得点右上角的“重新加载窗口”，否则配置不生效。
