VSCode Python调试问题通常由launch.json配置错误、Python解释器未正确选择、断点设置不当、日志模式未启用或扩展冲突引起；需依次检查调试配置、解释器路径、断点类型、debugpy日志及禁用干扰扩展。

如果您在VSCode中运行Python程序时遇到断点不触发、变量无法查看或调试器无响应等问题，则可能是由于调试配置不正确、Python解释器未正确选择或扩展功能未启用。以下是解决此问题的步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、配置launch.json调试设置

VSCode通过launch.json文件定义调试行为，包括启动方式、参数传递和环境变量注入，是调试流程的核心配置文件。

1、打开项目根目录，在资源管理器中点击“运行”侧边栏，选择“创建 launch.json 文件”。

立即学习“Python免费学习笔记（深入）”；

2、在弹出的环境列表中选择Python，系统将自动生成.vscode/launch.json文件。

3、在生成的配置中，确认"module"字段值为"python"或"script"字段指向正确的.py入口文件路径。

4、如需传递命令行参数，在"args"数组中添加字符串元素，例如["--verbose", "--port=8080"]。

二、正确选择Python解释器

调试器必须与目标Python环境完全一致，否则会出现包导入失败、版本不兼容或调试会话意外终止等问题。

1、按下Cmd+Shift+P（macOS）调出命令面板，输入并选择“Python: Select Interpreter”。

2、在列表中选择已安装的虚拟环境路径，例如./venv/bin/python或系统级Python 3.12解释器。

3、确认状态栏右下角显示所选解释器的完整路径，且无红色波浪线警告。

三、使用断点与调试控制台交互

断点是暂停执行以检查上下文的关键机制，而调试控制台支持实时执行表达式，验证变量状态或触发函数调用。

1、在代码行号左侧灰色区域单击，设置普通断点；按住Ctrl并单击可设置条件断点。

2、按F5启动调试，程序将在断点处暂停，此时变量窗格自动显示当前作用域全部变量。

3、在调试控制台中输入type(variable_name)或print(dir(object))，直接获取类型或属性信息。

四、启用日志调试模式

当断点失效或需追踪异步执行流时，启用调试日志可输出VSCode调试适配器与Python进程间的通信细节。

1、在launch.json中为对应配置添加字段："logToFile": true。

2、启动调试后，检查项目根目录下生成的debugpy-*.log文件，搜索"ERROR"或"timeout"关键词。

3、若发现"Failed to attach"错误，需确认debugpy版本与VSCode Python扩展版本兼容，当前推荐组合为debugpy 1.8.0+与Python扩展 v2025.12.0。

五、禁用扩展冲突调试

部分第三方扩展（如Pylance、Auto Import）可能劫持调试事件或修改AST解析逻辑，导致断点位置偏移或跳过。

1、按下Cmd+Shift+P，输入“Developer: Toggle Developer Tools”，打开开发者工具控制台。

2、在调试过程中观察Console标签页，记录是否出现“Extension host terminated”或“Debug adapter error”提示。

3、依次禁用非必要Python相关扩展，仅保留Python与Pylance，重启VSCode后重试调试。

# python  # 环境变量  # macos  # ai  # mac  # 工具  # macbook  # json  # js  # vscode  # 资源管理器