VSCode需手动指定Python解释器路径才能启用python命令、调试和语法检查；断点失效多因启动方式错误，应使用“Python File”配置而非默认F5；module模式等价于python -m，program模式等价于直接运行脚本。
如何确认VSCode已识别Python解释器
VSCode不会自动绑定系统Python，必须手动指定解释器路径，否则python命令、调试器、语法检查都会失效。打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入并选择 Python: Select Interpreter，从列表中选中你实际使用的环境（如 ./venv/bin/python 或 C:\Users\name\Anaconda3\python.exe）。如果列表为空，说明VSCode没找到任何Python安装——此时需先确保系统PATH中包含python或python3，或手动添加路径（点击“Enter interpreter path…”）。
为什么断点不生效或调试器直接跳过
常见原因不是配置错，而是启动方式不对：直接按F5会运行默认配置（可能指向launch.json里一个已删掉的脚本），或根本没生成launch.json。正确做法是：在要调试的.py文件中设好断点 → 按Ctrl+Shift+D打开调试视图 → 点击左上角绿色三角形旁的下拉菜单 → 选择Python File（这是VSCode内置的临时配置，无需手写launch.json）→ 再点运行。若仍无效，检查当前文件是否被保存（未保存的文件调试时可能加载旧版本），以及是否在调试状态下修改了代码但没重启调试会话。
launch.json里module和file模式的区别
二者决定Python如何执行你的代码，直接影响导入行为和工作目录：
-
"request": "launch", "module": "http.server"：等价于终端执行python -m http.server，适用于以模块形式运行的标准库或已安装包 -
"request": "launch", "program": "${file}"：等价于python /path/to/current.py，适合单文件脚本，但当前目录即为sys.path[0]，相对导入可能失败 - 用
module时，cwd参数控制模块查找起点；用program时，cwd影响open()等相对路径操作
多数项目建议用program配cwd，除非你明确需要-m语义（比如调试pip内部模块）。
立即学习“Python免费学习笔记（深入）”；
调试时看不到变量值或print()无输出
VSCode调试控制台默认只显示print()到stdout的内容，但某些场景会缓冲（尤其含换行符缺失时）或重定向：
- 在
print()里加flush=True强制输出：print("debug", flush=True) - 调试控制台不显示
logging默认输出，需在launch.json中加"console": "integratedTerminal"，让日志打到终端 - 变量未显示常因作用域问题：函数内定义的变量在函数外调试帧里不可见；局部变量名被优化（如
for i in range(10): pass里的i可能不显示） - 检查调试配置是否启用了
"justMyCode": true（默认开启），它会隐藏标准库和第三方包的栈帧——想看底层调用就得设为false
真正难排查的是多线程/异步代码：断点可能命中在非主线程，而VSCode默认只挂起当前线程，其他线程继续跑，导致状态瞬变。这种情况下，优先用logging打时间戳日志，比依赖断点更可靠。
