VSCode中按工作区目录自动切换Python虚拟环境的方法

核心思路 #

利用VSCode的多根工作区功能，为每个子项目目录单独配置对应的Python虚拟环境，实现打开不同目录文件时自动切换解释器，并同步适配Pylance、pylint、yapf等工具。

具体配置步骤 #

1. 创建多根工作区文件 #

• 打开VSCode，点击左侧资源管理器的「添加文件夹到工作区」，依次将my_workspace/project_A和my_workspace/project_B加入工作区。
• 点击菜单栏「文件 → 将工作区另存为」，将工作区文件保存到my_workspace目录下，命名为my_workspace.code-workspace。

2. 编辑工作区配置 #

打开my_workspace.code-workspace文件，替换内容为以下配置（注意根据你的Python版本和系统调整路径）：

{
  "folders": [
    {
      "name": "project_A",
      "path": "./project_A",
      "settings": {
        // 指定project_A对应的虚拟环境解释器路径
        "python.defaultInterpreterPath": "~/.virtualenvs/venv_A/bin/python",
        // 让Pylance识别虚拟环境的第三方包
        "python.analysis.extraPaths": ["~/.virtualenvs/venv_A/lib/python3.9/site-packages"],
        // 指定虚拟环境内的pylint路径
        "python.linting.pylintPath": "~/.virtualenvs/venv_A/bin/pylint",
        // 指定虚拟环境内的yapf路径
        "python.formatting.yapfPath": "~/.virtualenvs/venv_A/bin/yapf"
      }
    },
    {
      "name": "project_B",
      "path": "./project_B",
      "settings": {
        "python.defaultInterpreterPath": "~/.virtualenvs/venv_B/bin/python",
        "python.analysis.extraPaths": ["~/.virtualenvs/venv_B/lib/python3.9/site-packages"],
        "python.linting.pylintPath": "~/.virtualenvs/venv_B/bin/pylint",
        "python.formatting.yapfPath": "~/.virtualenvs/venv_B/bin/yapf"
      }
    }
  ],
  "settings": {
    // 全局通用配置（可选）
    "python.linting.enabled": true,
    "python.formatting.provider": "yapf"
  }
}

注意：

• Windows系统下，虚拟环境解释器路径格式为~/.virtualenvs/venv_A/Scripts/python.exe，工具路径同理改为Scripts目录下的可执行文件。
• 替换配置中的python3.9为你实际使用的Python版本号（可通过python --version查看）。

3. 验证配置效果 #

• 关闭并重新打开my_workspace.code-workspace工作区。
• 打开project_A/script_A.py，查看VSCode右下角状态栏的Python解释器，应显示为venv_A；打开project_B/script_B.py，应显示为venv_B。
• 测试代码检查和格式化：在对应文件中编写不符合pylint规范的代码，查看是否有对应提示；使用快捷键格式化代码，验证yapf是否正常工作。

补充说明 #

• 若你的pylint、yapf是安装在虚拟环境内的，配置工具路径可确保VSCode使用对应环境的版本，避免全局版本与虚拟环境依赖冲突。
• 关于你提到的GitHub未关闭问题（基于文件夹.python-version文件选择pyenv环境），当前方案无需依赖该功能，通过多根工作区即可实现需求。

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