VSCode配置Python多项目并发开发环境-VSCode-PHP中文网

vscode必须为每个项目单独配置解释器和工作区设置，否则环境会相互污染；需在每个项目根目录创建.vscode/settings.json，明确指定python.defaultinterpreterpath路径，并配合launch.json设置cwd和env以确保调试、终端、导入等行为正确隔离。

vscode配置python多项目并发开发环境

VSCode 本身不支持“全局 Python 环境并发”，必须为每个项目单独配置解释器和工作区设置，否则 pip install、import、调试断点都会相互污染。

每个项目必须用独立的 `.vscode/settings.json`

VSCode 的 Python 解释器绑定在工作区（即文件夹）级别，不是用户级或窗口级。如果你打开多个文件夹（比如用 File → Add Folder to Workspace），每个文件夹需有自己的 .vscode/settings.json，否则后打开的项目会覆盖前一个的 python.defaultInterpreterPath 设置。

手动创建 .vscode/settings.json，内容至少包含：
```
{
  "python.defaultInterpreterPath": "./venv/bin/python"
}
```
（macOS/Linux）或 "./venv/Scripts/python.exe"（Windows）
不要依赖命令面板里的 Python: Select Interpreter 全局选择——它只写入当前工作区的 settings.json，且不会自动保存到磁盘，关掉再开可能丢失
如果项目用了 poetry 或 conda，路径要指向具体环境二进制，例如 "~/.cache/pypoetry/virtualenvs/myproj-abc123-py3.11/bin/python"

`launch.json` 的 `cwd` 和 `env` 必须显式指定

多项目共存时，VSCode 调试器默认从“工作区根目录”启动，但若你在一个大工作区里开了多个子项目（比如 monorepo），cwd 错了会导致 ModuleNotFoundError 或读错配置文件。

python-code-analyz

专业Python代码分析与优化，支持语法检查、安全扫描、性能评估、复杂度分析及重构后优化代码生成。

下载

每个项目的 .vscode/launch.json 必须设 "cwd": "${workspaceFolder}/subproject-a"，不能省略
需要隔离环境变量（如 DJANGO_SETTINGS_MODULE、FLASK_APP）时，直接在 env 字段写死，别指望靠终端激活虚拟环境来传递
避免使用 "justMyCode": false 调试多项目——它会让 VSCode 进入所有已加载的 Python 包源码，极大拖慢断点响应

终端自动激活对应虚拟环境失败？检查 `python.terminal.executeInFileDir`

VSCode 默认终端启动时不会自动 source venv/bin/activate，尤其当你从非项目根目录打开文件、再唤起终端时，which python 仍显示系统 Python。

在项目级 settings.json 中加：
```
"python.terminal.executeInFileDir": true
```
，让终端 cd 到当前编辑文件所在目录再启动
同时启用 "python.terminal.launchArgs": ["-i"] 可让终端进入交互模式，方便验证 sys.executable
禁用 python.terminal.launchArgs 中的 -E（忽略环境变量）参数，否则 venv 的 PYTHONPATH 不生效

最常被忽略的一点：VSCode 的 Python 扩展会缓存 python.defaultInterpreterPath 值，哪怕你删了 settings.json，重启后仍可能沿用旧路径——务必在命令面板运行 Python: Clear Cache and Reload Window 再验证。另外，pylint 或 mypy 的路径也要单独配在 settings.json 里，它们不继承解释器路径。