如何用VSCode调试从GitHub Fork的修改版Python库？

以下是几个更高效的方案，替代修改库名和导入语句的繁琐操作：

方案一：确保pip install -e生效+选对VSCode解释器 #

• 在你本地Fork的库根目录（含setup.py/pyproject.toml的目录）执行：

  pip install -e .
  

  这会以可编辑模式安装库，Python的site-packages里会生成指向本地目录的链接，而非复制文件。
• 打开VSCode后，点击右下角的Python解释器选择框，切换到执行了上述命令的环境（比如虚拟环境、全局环境，确保环境一致）。
• 验证：在VSCode终端执行：

  python -c "import XXX; print(XXX.__file__)"
  

  若输出路径是你本地修改的库目录，说明配置生效，调试时会直接加载本地代码。

方案二：通过调试配置强制指定模块路径 #

如果可编辑安装没生效，或不想用该模式，直接修改VSCode调试配置：

• 在项目根目录创建.vscode/launch.json（若已有则直接编辑），在调试配置中添加PYTHONPATH环境变量，优先加载本地库：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: Current File",
              "type": "python",
              "request": "launch",
              "program": "${file}",
              "console": "integratedTerminal",
              "env": {
                  "PYTHONPATH": "${workspaceFolder}/path/to/your/local/repo:${env:PYTHONPATH}"
              }
          }
      ]
  }
  

  把${workspaceFolder}/path/to/your/local/repo替换为你本地Fork仓库的根目录（即包含XXX库文件夹的上级目录）。

方案三：配置VSCode语言分析路径（解决智能提示+调试一致性） #

• 打开VSCode设置（快捷键Ctrl+,），搜索Python > Analysis: Extra Paths，点击编辑 in settings.json，添加本地库根目录：

  "python.analysis.extraPaths": [
      "${workspaceFolder}/path/to/your/local/repo"
  ]
  

  该设置让VSCode的语言服务识别本地库，解决代码跳转、智能提示指向原库的问题，配合调试配置即可实现调试与代码修改同步。

额外注意事项 #

• 优先用虚拟环境隔离开发环境，避免全局环境的库版本冲突。
• 可编辑模式下，修改本地代码后无需重新安装，直接保存即可生效。
• 若仍指向原库，检查pip list输出中目标库是否标注editable project located at ...，若没有则重新执行pip install -e .。

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