核心摘要 (TL;DR)

• 问题痛点：默认情况下，VS Code 的调试器会跳过所有第三方库代码，导致我们无法观察依赖包内部的执行逻辑。
• 关键配置：通过在 launch.json 中将 justMyCode 设为 false，解除调试限制。
• 实战技巧：配合虚拟环境激活，精准定位并单步调试第三方库源码。

前言

各位友人们好啊。在日常折腾 Python 的过程中，咱们经常会遇到这样的情况：自己的代码逻辑看起来天衣无缝，但一运行就报个奇奇怪怪的错，而且报错位置深藏在某个第三方库的肚子里。

常规的调试模式下，VS Code 就像一个贴心的（但有时多管闲事的）管家，默认只带你在你写的代码里转悠，一旦涉及到 site-packages 里的库文件，它就直接“跳”过去。这虽然清爽，但对于排查深层 Bug 来说简直是灾难。

这节咱们就来解决这个痛点，让调试器带咱们深入“敌方内部”。

1. 核心配置：关闭 justMyCode

VS Code 的 Python 调试插件默认开启了一个叫 justMyCode 的功能。顾名思义，它只关心“你的代码”。要打破这个黑盒，咱们得手动修改配置。

1.1 创建或打开 launch.json

1. 点击 VS Code 左侧侧边栏的 “运行和调试” 图标。
2. 如果你还没有配置文件，点击 “创建 launch.json 文件”。
3. 在弹出的环境选择框中，选择 Python Debugger。
4. 接着选择具体的配置模板，通常选择 Python File（调试当前文件）即可。

1.2 修改配置参数

在生成的 launch.json 文件中，找到 configurations 数组。我们需要在对应的配置项里添加一行 "justMyCode": false。

完整的配置参考如下：

1
2
3
4
5
6
7
8
9
10
11
12
13

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python Debugger: Current File",
      "type": "debugpy",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "justMyCode": false
    }
  ]
}