VS Code多根工作区多虚拟环境下Python调试器路径配置问询

我来给你梳理下多根工作区下配置不同虚拟环境调试的具体方案，亲测好用！核心思路就是给每个项目目录单独指定Python解释器路径，彻底避免全局设置带来的冲突。VS Code支持在工作区级别或者单个项目的配置文件里做设置，调试器则通过launch.json精准指定对应环境。

1. 先搞定工作区根配置（.code-workspace） #

首先你的工作区结构大概是这样的（我给你举个典型例子）：

my-multi-root-workspace.code-workspace
├── project-flask-1/
│   ├── .venv/          # 项目1专属的虚拟环境
│   ├── app.py
│   └── .vscode/
├── project-flask-2/
│   ├── .venv/          # 项目2专属的虚拟环境
│   ├── app.py
│   └── .vscode/
└── project-other/
    ├── .venv/          # 其他项目的虚拟环境
    └── script.py

在.code-workspace文件里，你可以为每个文件夹单独设置默认Python解释器，这样打开对应项目的文件时，VS Code会自动切换到对应的环境：

{
  "folders": [
    {
      "name": "Flask App 1",
      "path": "./project-flask-1"
    },
    {
      "name": "Flask App 2",
      "path": "./project-flask-2"
    },
    {
      "name": "Other Project",
      "path": "./project-other"
    }
  ],
  "settings": {
    // 给每个项目指定专属的Python解释器路径
    "python.pythonPath": {
      "Flask App 1": "${workspaceFolder:Flask App 1}/.venv/bin/python", // macOS/Linux用这个
      // "Flask App 1": "${workspaceFolder:Flask App 1}\\.venv\\Scripts\\python.exe", // Windows换成这个
      "Flask App 2": "${workspaceFolder:Flask App 2}/.venv/bin/python",
      "Other Project": "${workspaceFolder:Other Project}/.venv/bin/python"
    }
  }
}

小提示：Windows系统的路径记得用双反斜杠转义，不过直接用正斜杠VS Code也能识别，不用太纠结。

2. 每个项目单独配置launch.json调试文件 #

这一步是关键，每个项目的.vscode/launch.json必须单独设置，确保调试时用的是自己的虚拟环境。

Flask项目1的launch.json（project-flask-1/.vscode/launch.json） #

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flask App 1 Debug", // 名字随便取，好认就行
      "type": "python",
      "request": "launch",
      "module": "flask",
      "env": {
        "FLASK_APP": "app.py", // 你的Flask入口文件
        "FLASK_ENV": "development",
        "FLASK_DEBUG": "1"
      },
      "args": [
        "run",
        "--no-debugger", // 因为VS Code自己带调试器，这里关掉Flask自带的避免冲突
        "--no-reload"
      ],
      // 指定当前项目的虚拟环境Python路径
      "python": "${workspaceFolder}/.venv/bin/python", // macOS/Linux
      // "python": "${workspaceFolder}\\.venv\\Scripts\\python.exe", // Windows
      "justMyCode": true
    }
  ]
}

Flask项目2的launch.json（project-flask-2/.vscode/launch.json） #

和项目1类似，只需要确保路径和名字对应上就行：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flask App 2 Debug",
      "type": "python",
      "request": "launch",
      "module": "flask",
      "env": {
        "FLASK_APP": "app.py",
        "FLASK_ENV": "development",
        "FLASK_DEBUG": "1"
      },
      "args": [
        "run",
        "--no-debugger",
        "--no-reload"
      ],
      "python": "${workspaceFolder}/.venv/bin/python", // macOS/Linux
      // "python": "${workspaceFolder}\\.venv\\Scripts\\python.exe", // Windows
      "justMyCode": true
    }
  ]
}

其他普通Python项目的launch.json（project-other/.vscode/launch.json） #

如果是普通脚本，配置更简单：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Other Project Script",
      "type": "python",
      "request": "launch",
      "program": "${file}", // 调试当前打开的文件
      "python": "${workspaceFolder}/.venv/bin/python", // macOS/Linux
      // "python": "${workspaceFolder}\\.venv\\Scripts\\python.exe", // Windows
      "console": "integratedTerminal"
    }
  ]
}

3. 可选：单个项目的settings.json #

如果你不想在.code-workspace里统一配置，也可以在每个项目的.vscode/settings.json里单独设置默认解释器，比如project-flask-1/.vscode/settings.json：

{
  "python.pythonPath": "${workspaceFolder}/.venv/bin/python" // macOS/Linux
  // "python.pythonPath": "${workspaceFolder}\\.venv\\Scripts\\python.exe" // Windows
}

最后验证配置是否生效 #

1. 打开某个项目的Python文件，看VS Code右下角状态栏的Python解释器，是不是显示对应虚拟环境的路径
2. 启动调试后，看终端里的激活信息，确认用的是当前项目的虚拟环境

这样配置完，每个项目的调试都会独立使用自己的虚拟环境，再也不会出现路径或者依赖冲突的问题啦！

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