如何在VSCode中配置Python项目调试功能-VSCode-PHP中文网

断点失效、ModuleNotFoundError等根本原因是VS Code未正确识别Python项目环境：必须确保解释器路径、调试入口（program/module）、配置路径（launch.json位置）三者严格一致，且debugpy已安装并匹配当前解释器。

如何在vscode中配置python项目调试功能

断点打不上、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 版本是否和你 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 启动的调试上下文完全不同。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！