VS Code多根工作区调试Python应用时如何加载本地实时依赖？

针对你在多根工作区中调试Python应用时，希望直接加载本地依赖库实时代码的需求，以下是几种跨平台、可提交到版本控制的解决方案：

方法1：利用VS Code Python插件的extraPaths配置（跨平台，推荐） #

VS Code的Python插件内置了路径处理能力，可自动适配不同平台的路径分隔符，无需手动维护PYTHONPATH。

配置方式（二选一） #

方式A：工作区全局配置（对所有启动项生效）

在product.code-workspace文件中添加settings字段，直接指定本地依赖的根目录：

{
    "folders": [
        { "path": "app" },
        { "path": "lib" }
    ],
    "settings": {
        "python.analysis.extraPaths": [
            "${workspaceFolder:lib}"
        ]
    }
}

如果有多个依赖（如lib1、lib2），直接追加到数组即可：

"python.analysis.extraPaths": [
    "${workspaceFolder:lib1}",
    "${workspaceFolder:lib2}"
]

方式B：仅针对特定启动项配置

在app项目的.vscode/launch.json中，给调试配置添加env字段，使用VS Code内置的${pathSeparator}自动适配平台：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: app",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "env": {
                "PYTHONPATH": "${env:PYTHONPATH}${pathSeparator}${workspaceFolder:lib}"
            }
        }
    ]
}

多依赖场景下继续追加路径：

"PYTHONPATH": "${env:PYTHONPATH}${pathSeparator}${workspaceFolder:lib1}${pathSeparator}${workspaceFolder:lib2}"

配置完成后，修改lib的代码无需提交或重新安装依赖，启动调试即可加载最新内容。

方法2：将本地依赖以可编辑模式安装到app的虚拟环境 #

这是Python生态原生的解决方案，通过可编辑安装让Python直接引用本地文件系统中的代码：

操作步骤 #

1. 激活app的虚拟环境：

   # Linux/macOS
   source app/.venv/bin/activate
   # Windows
   app\.venv\Scripts\activate
   

2. 安装本地lib为可编辑依赖：

   pip install -e ../lib
   

3. 多依赖场景依次执行：

   pip install -e ../lib1 -e ../lib2
   

团队协作时，可将本地依赖路径添加到requirements.txt：

# requirements.txt
-e ../lib
-e ../lib1

其他成员克隆项目后，执行pip install -r requirements.txt即可自动配置。

方法3：若使用Poetry管理依赖 #

如果项目用Poetry，可直接添加本地可编辑依赖：

poetry add ../lib --editable

Poetry会在pyproject.toml中生成如下配置：

[tool.poetry.dependencies]
lib = { path = "../lib", develop = true }

这种方式同样跨平台，修改lib代码后直接生效，无需额外VS Code配置。

验证效果 #

按照上述任意方法配置后，修改lib/lib/__init__.py的返回值为"goodbye"，启动app调试会话，控制台会输出goodbye而非原有的hello world。

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