VSCode调试Python出现'Unverified breakpoint'问题及launch.json修改方法

我之前调试Python项目时也碰到过一模一样的情况——主文件的断点正常触发，但其他被调用的文件断点总是显示'Unverified breakpoint'直接被跳过。这大概率是调试配置里的工作目录或Python路径没设置对，导致调试器找不到那些子文件的正确映射。

针对你现有的launch.json，只需要修改常用的调试配置项（比如你常用的"Python: Current File"），添加几个关键参数就能解决：

修改后的核心配置示例 #

{
    "name": "Python: Current File",
    "type": "python",
    "request": "launch",
    "program": "${file}",
    "cwd": "${workspaceFolder}",
    "env": {
        "PYTHONPATH": "${workspaceFolder}"
    },
    "justMyCode": false
}

关键参数说明 #

• "cwd": "${workspaceFolder}"：将调试会话的工作目录设置为你的项目根目录。这样调试器会基于项目根来解析所有文件路径，不会因为当前运行文件在子目录而找不到其他模块的断点。
• PYTHONPATH 环境变量：把项目根目录加入Python的路径列表，确保解释器能正确导入你的自定义模块，同时让调试器能关联到这些文件的断点信息。
• "justMyCode": false：关闭这个默认选项后，调试器不会忽略你项目中任何自定义代码的断点（默认情况下偶尔会把子目录的代码误判为"非自己的代码"）。

额外注意事项 #

如果你常用其他调试配置（比如"Python: Module"或者"Django"配置），也需要给它们加上同样的cwd和PYTHONPATH配置，确保所有调试场景下都能识别跨文件断点。

修改完配置后，记得重启VSCode的调试会话，或者按Ctrl+Shift+P执行"Reload Window"，让新配置生效。

内容的提问来源于stack exchange，提问作者locke14