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扩展 v2024.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后重试调试。
