VSCode无法调试第三方Python包及添加外部代码断点问题

确认调试配置位置 #

• 必须在launch.json的具体调试配置中设置justMyCode: false，而非全局设置。正确配置示例：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: 当前文件",
              "type": "python",
              "request": "launch",
              "program": "${file}",
              "console": "integratedTerminal",
              "justMyCode": false
          }
      ]
  }
  

• 若使用Python: Attach调试模式，需在对应配置项中同样添加"justMyCode": false。

匹配Python解释器环境 #

• 确保VSCode选用的Python解释器与第三方包安装环境一致（比如虚拟环境）。可通过左下角状态栏切换版本，调试器会自动关联该环境下的包路径。
• 若包路径未被识别，可在命令面板（Cmd+Shift+P）执行Python: Select Interpreter重新选择对应解释器。

处理未加载的断点 #

• 非项目目录代码的断点若显示为灰色空心圆点，说明调试器未加载该文件，可尝试：
  1. 在目标代码中插入import pdb; pdb.set_trace()临时触发调试，VSCode会自动加载文件，之后即可正常添加断点。
  2. 在launch.json中添加"env": {"PYTHONPATH": "${workspaceFolder}:/path/to/third-party-package"}，将第三方包路径加入Python环境变量，确保调试器能定位到源码。

排查扩展与版本问题 #

• 禁用Python Extension Pack中多余的扩展，仅保留Microsoft官方Python扩展，避免冲突。
• 重启VSCode确保配置生效，若问题仍存在，可尝试回退Python扩展至前一稳定版本。

其他注意事项 #

• 确认第三方包为源码.py文件，而非编译后的.pyc文件，调试器无法对编译文件添加断点。
• 若通过pip安装包，使用pip install -e <包本地路径>以可编辑模式安装，让VSCode直接关联源码。

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