如何在vscode中集成终端并执行Shell命令【教程】-VSCode-PHP中文网

VS Code内置终端开箱即用，默认按Ctrl+`呼出，工作目录为打开文件夹根路径；支持多标签、shell切换及自动激活Python虚拟环境；路径和环境变量问题需按系统配置shell配置文件或PATH；命令卡住可用Ctrl+C中断或后台运行；tasks.json中命令失败因非交互式shell，需显式指定路径或注入PATH环境变量。

如何在vscode中集成终端并执行shell命令【教程】

VS Code 内置终端就是开箱即用的，不需要“集成”——你只需要知道它默认在哪、怎么调、为什么有时命令不生效。

终端快捷键和启动位置

按 Ctrl+`（反引号，在 Tab 上方）即可呼出或隐藏集成终端。它默认在编辑器底部面板中启动，工作目录是当前打开文件夹的根路径（即你通过 File → Open Folder 打开的那个目录）。

如果没反应，检查是否被系统或其他插件占用了该快捷键；也可以通过菜单栏 Terminal → New Terminal 手动创建。

多个终端标签页可共存，用 Ctrl+Shift+` 新建一个
右键终端标签页可重命名、复制路径、或选择 shell 类型（如 PowerShell、zsh、bash）
终端启动后自动激活当前 workspace 的 Python 虚拟环境（如果有 .venv 或 venv 目录且配置了 python.defaultInterpreterPath）

执行 Shell 命令时路径和环境变量不对

常见现象：在资源管理器里双击进入子文件夹，但终端里 pwd 显示的仍是父目录；或者 npm run dev 报错说找不到命令——本质是终端没加载你的 shell 配置文件（如 ~/.zshrc），或 VS Code 启动时没读取系统 PATH。

解决方式取决于你的操作系统：

从 Git 仓库历史中彻底删除文件

|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件

下载

macOS：在 ~/.zprofile 中设置 PATH，并确保 VS Code 是从终端用 code . 启动（而非桌面图标），否则 shell 环境不会继承
Windows：检查 terminal.integrated.profiles.windows 设置中是否指定了正确的 PowerShell 或 Command Prompt 路径；若用 Git Bash，需手动添加 profile 并设为默认
Linux：多数桌面环境能正确继承，但若用 Snap 安装的 VS Code，会因沙盒限制无法读取 ~/.bashrc，建议改用 .deb 或官网 tarball 版本

{
  "terminal.integrated.profiles.linux": {
    "bash": {
      "path": "/bin/bash",
      "args": ["-l"] // 加 -l 参数让 bash 以登录模式启动，加载 ~/.bashrc
    }
  },
  "terminal.integrated.defaultProfile.linux": "bash"
}

终端里运行脚本或命令没反应 / 卡住

不是 VS Code 的问题，而是 shell 进程本身被阻塞了：比如你运行了 node server.js，服务没加 --watch 或后台标志，终端就一直占用着，没法输下一条命令。

用 Ctrl+C 中断当前前台进程（别用鼠标点关闭按钮）
需要长期运行又不想占终端？加 & 后台运行：npm run dev &；更稳妥用 npx concurrently 或 nodemon --quiet
想保留输出日志还方便查看？重定向到文件：npm test > test.log 2>&1
终端编码异常（中文变问号）？检查 terminal.integrated.env.linux 是否设置了 LANG=en_US.UTF-8

为什么某些命令在终端可用，但在 tasks.json 里就失败

因为 tasks.json 默认使用非登录、非交互式 shell，不加载用户配置，PATH 更精简。例如全局安装的 pnpm 在终端里能用，但 task 里提示 command not found。

两个务实解法：

显式写全路径：/home/username/.local/bin/pnpm install（用 which pnpm 查）

在 task 配置里注入环境变量：

{
  "version": "2.0.0",
  "tasks": [{
    "label": "install",
    "type": "shell",
    "command": "pnpm install",
    "options": {
      "env": {
        "PATH": "/home/username/.local/bin:/usr/local/bin:${env:PATH}"
      }
    }
  }]
}

真正麻烦的是跨平台 task：Windows 的 %USERPROFILE% 和 macOS 的 $HOME 不通用，这时别硬拼 PATH，优先用 VS Code 提供的变量如 ${env:HOME} 或 ${env:USERPROFILE}。