断点失效、ModuleNotFoundError等根本原因是VS Code未正确识别Python项目环境：必须确保解释器路径、调试入口（program/module）、配置路径（launch.json位置）三者严格一致，且debugpy已安装并匹配当前解释器。
断点打不上、F5 按下去直接报错、ModuleNotFoundError、灰色空心断点——这些问题不是你代码写错了，而是 VS Code 还没真正“认出”你的 Python 项目。核心就一条：调试功能必须基于正确的解释器 + 可执行入口 + 可信的配置路径，三者缺一不可。
怎么选对 Python 解释器？别信下拉列表自动识别
VS Code 的 Python 插件会扫描 PATH、常见安装目录、虚拟环境路径，但顺序固定、不回溯。它可能找到系统 Python 3.9，而你项目要求 3.11+，结果 pip install 失败、import 报错，调试根本启动不了。
- 手动指定路径最稳：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，然后选Enter interpreter path...，粘贴你真实环境的python.exe或python3.11绝对路径 - 验证是否生效：打开集成终端（
Ctrl+`），执行which python（macOS/Linux）或where python（Windows），输出必须和你在选择解释器时看到的路径一致 - conda 环境用户注意：
conda activate myenv后再打开 VS Code，否则插件可能找不到./envs/myenv/bin/python
launch.json 配置里哪些字段不能乱改？
自动生成的 launch.json 通常只填了 program 和 console，但实际项目往往需要更多控制。关键字段含义和易错点如下：
-
request必须是"launch"（启动新进程）或"attach"（挂载已有进程），写成"run"或留空会直接报错 -
program推荐用"${file}"（当前文件）或"${workspaceFolder}/main.py"（固定入口），避免写死绝对路径，否则换机器就失效 -
python字段已弃用；真正起作用的是解释器路径本身，由上一步的Select Interpreter决定，不是launch.json里写的 - 要传命令行参数？加
"args": ["--debug", "prod"]，不是塞进program字符串里
为什么断点变灰、程序不暂停？
灰色断点 = VS Code 认为这行代码“不会被执行”，常见原因不是配置错，而是路径映射失败或模块未加载。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
- 检查右下角状态栏：显示的 Python 版本是否和你
pip list查到的一致？不一致说明解释器选错了 - 如果项目结构是
src/main.py+src/utils/helpers.py，但你在main.py里from utils.helpers import foo，VS Code 默认不把src当作根包；需在launch.json中加"env": {"PYTHONPATH": "${workspaceFolder}/src"} - 异步代码（
async def）、多进程（multiprocessing）默认不支持断点穿透，调试器只停在主进程；想调试子进程，得单独配request: "attach"并在子进程中插入debugpy.listen(5678)
调试前必须确认的三件事
很多问题其实发生在“按 F5 之前”，而不是调试过程中。
- 确保已安装
debugpy：在当前解释器环境下运行python -m pip install --upgrade debugpy，不要用系统 Python 的 pip 装到别的环境里 - 检查
.vscode/launch.json是否在工作区根目录，而不是嵌套在子文件夹里；VS Code 只读取打开文件夹下的该文件 - 禁用其他 Python 插件干扰：比如 Pylance 是语言服务，不影响调试；但某些第三方调试扩展（如旧版 Python Debugger）会和官方
ms-python.python冲突，卸载掉
最常被忽略的其实是“解释器路径”和“工作区根目录”的耦合关系——VS Code 不是根据你打开的 .py 文件定位环境，而是根据你通过 code . 打开的那个文件夹。换言之，cd myproject && code . 和 code myproject/main.py 启动的调试上下文完全不同。
