如何在VSCode中为Python虚拟环境配置特定Shell的快捷键任务？

解决步骤 #

1. 编写一键激活虚拟环境的运行脚本 #

在项目根目录新建run_script.sh文件，内容如下：

#!/bin/bash
# 激活虚拟环境（路径替换成你自己的venv位置）
source ./venv/bin/activate
# 运行当前打开的Python文件
python "$1"
# 可选：保持终端不关闭，方便查看输出
exec $SHELL

保存后给脚本添加执行权限：

chmod +x run_script.sh

2. 配置VS Code自定义任务 #

打开命令面板（Ctrl+Shift+P），搜索「任务: 打开tasks.json」，选择「创建tasks.json文件」，将默认内容替换为：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run Python in Venv",
            "type": "shell",
            "command": "${workspaceFolder}/run_script.sh ${file}",
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "problemMatcher": [],
            "presentation": {
                "reveal": "always",
                "panel": "dedicated" // 固定使用同一个终端运行
            }
        }
    ]
}

其中${file}会自动传入当前打开的Python文件路径，panel: dedicated确保每次都在指定终端执行，不会新开窗口。

3. 绑定自定义快捷键 #

打开命令面板，搜索「首选项: 打开键盘快捷方式(JSON)」，在keybindings.json中添加以下配置：

{
    "key": "ctrl+shift+r", // 替换成你习惯的快捷键组合
    "command": "workbench.action.tasks.runTask",
    "args": "Run Python in Venv"
}

保存后，按下设置的快捷键就能直接在虚拟环境中运行当前Python文件。

补充说明 #

• Windows系统需将脚本改为.bat格式，激活命令替换为venv\Scripts\activate.bat，tasks中的命令对应改为${workspaceFolder}/run_script.bat ${file}。
• 不需要终端保持打开的话，删除脚本里的exec $SHELL即可。

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