如何在VS Code中为Python项目创建并运行专属虚拟环境

1. 创建项目专属虚拟环境 #

用Python自带的venv模块即可，无需额外安装工具：

• 打开VS Code，加载你的项目根文件夹
• 打开内置终端（快捷键Ctrl+`，或菜单栏选「终端>新建终端」）
• 执行对应系统的命令创建环境：
  Windows：python -m venv .venv
  Mac/Linux：python3 -m venv .venv
  这里.venv是常用的隐藏环境文件夹名，也可以自定义名称（比如project_env），用.开头不会占用目录列表的显眼位置，更整洁
• 命令执行完成后，项目根目录会多出一个.venv文件夹（Windows需手动开启「显示隐藏文件」才能看到）

2. 在VS Code中关联虚拟环境 #

让VS Code识别并使用这个独立环境：

• 打开命令面板（快捷键Ctrl+Shift+P / Cmd+Shift+P）
• 输入 Python: Select Interpreter 并回车
• 在弹出的列表里找到刚才创建的环境，路径大致为：
  Windows：./.venv/Scripts/python.exe
  Mac/Linux：./.venv/bin/python3
  选中该选项即可
• 正常情况下终端会自动激活环境（终端前缀会显示(.venv)），如果没自动激活，手动执行激活命令：
  Windows：.venv\Scripts\activate
  Mac/Linux：source .venv/bin/activate

3. 让指定程序在独立环境运行 #

方式一：终端直接运行 #

确保终端已激活环境（能看到(.venv)前缀），直接输入命令运行脚本：
Windows：python your_script.py
Mac/Linux：python3 your_script.py
替换your_script.py为目标脚本的文件名或路径即可，脚本会自动使用虚拟环境的Python版本和已安装依赖。

方式二：用VS Code运行按钮指定环境 #

如果想点击绿色运行三角就用虚拟环境执行脚本，配置launch.json：

• 打开要运行的脚本文件
• 点击左侧「运行和调试」图标（快捷键Ctrl+Shift+D）
• 点击「创建launch.json文件」，选择「Python」>「Python文件」
• 修改生成的launch.json内容，注意替换python路径为你的虚拟环境解释器路径：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 虚拟环境运行当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "python": "${workspaceFolder}/.venv/Scripts/python.exe" // Mac/Linux改为${workspaceFolder}/.venv/bin/python3
        }
    ]
}

• 保存后，打开指定脚本点击运行按钮，就会用该虚拟环境执行。

方式三：配置任务批量/自定义运行 #

如果需要固定运行某个脚本或添加自定义参数，配置tasks.json：

• 打开命令面板，输入Tasks: Configure Task，选择「创建tasks.json文件」>「Others」
• 修改内容如下，注意替换脚本路径和Python环境路径：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "虚拟环境运行指定脚本",
            "type": "shell",
            "command": "${workspaceFolder}/.venv/Scripts/python.exe ${workspaceFolder}/path/to/target_script.py", // Mac/Linux修改Python路径
            "args": [], // 可添加脚本参数，比如["--mode", "debug"]
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": []
        }
    ]
}

• 按Ctrl+Shift+B即可触发任务，自动用虚拟环境运行指定脚本。

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