如何在VSCode中使用终端并执行命令行任务【教程】

12次阅读

vscode内置终端开箱即用,快捷键Ctrl+/Cmd+呼出;支持多标签页与shell切换;npm run dev失败常因路径错误或node.js未加入PATH;需配置settings.json设置默认终端及环境变量。

如何在VSCode中使用终端并执行命令行任务【教程】

VSCode 内置终端不是“需要额外安装”的功能,而是开箱即用的核心组件——只要 VSCode 本身能运行,Terminal 就在。

如何快速打开和切换终端

默认快捷键是 Ctrl+`windows/linux)或 Cmd+`macos),按一次就呼出集成终端面板;再按一次可隐藏。如果没反应,检查是否被系统或其他软件劫持了该快捷键。

  • 多个终端实例可共存:点击终端面板右上角 + 图标新建标签页,每个标签页独立运行一个 shell 进程
  • 终端类型可切换:点击面板右下角的下拉箭头(如显示 bashPowerShell),可选 Command promptgit Bashzsh 等——前提是对应 shell 已安装且路径被系统识别
  • 关闭某个终端标签页,不会影响其他标签页,也不会终止 VSCode 主进程

为什么执行 npm run dev 没反应或报错 “command not found”

常见原因是终端启动时未进入项目根目录,或当前 shell 未加载 Node.js 环境(尤其在 macOS 使用 zsh / fish,或 Windows 使用 PowerShell 时)。

  • 确认工作目录:终端启动后自动进入 VSCode 当前打开的文件夹,但若你通过 File > Open Folder 打开的是子目录,package.json 可能不在当前路径下——用 pwd(macOS/Linux)或 cd(Windows)确认,必要时手动 cd 到含 package.json 的目录
  • 检查 node.js 是否可用:输入 node -vnpm -v,若提示“not recognized”或“command not found”,说明 shell 无法定位 Node.js 安装路径。此时需检查:PATH 环境变量是否包含 Node.js 安装目录(如 /usr/local/binC:Program Filesnodejs),或 VSCode 是否以“从命令行启动”方式打开(推荐使用 code . 启动,确保继承 shell 的完整环境)
  • PowerShell 默认策略限制脚本执行:若看到类似 execution of scripts is disabled 错误,临时允许当前会话执行脚本:运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

如何配置默认终端和启动行为

VSCode 不会自动读取系统默认 shell,必须显式配置。设置项位于 settings.json 中,而非 GUI 设置界面(GUI 设置里只有部分选项,易遗漏关键字段)。

{   "terminal.integrated.defaultProfile.windows": "PowerShell",   "terminal.integrated.defaultProfile.osx": "zsh",   "terminal.integrated.defaultProfile.linux": "bash",   "terminal.integrated.profiles.windows": {     "PowerShell": {       "source": "PowerShell",       "icon": "terminal-powershell"     },     "Command Prompt": {       "path": ["cmd.exe"],       "args": ["/k", "echo Welcome to CMD"]     }   } }
  • defaultProfile 控制新建终端时默认启动哪个 shell
  • profiles 定义每个可选终端的具体启动参数,比如加 /k 表示执行完命令后保持窗口打开
  • 修改后无需重启 VSCode,新打开的终端即生效;已有终端不受影响
  • 注意:macOS 上若安装了 Homebrew 版 zsh,路径通常正确;但若用 Oh My Zsh,确保 ~/.zshrc 中的 export PATH=... 已生效(VSCode 启动时会读取该文件)

最常被忽略的一点:终端继承的是 VSCode 启动时的环境变量,不是你当前桌面会话中新开 Terminal.app 或 cmd.exe 的环境。如果改过 PATH 或安装了新工具,务必重启 VSCode(不只是关终端),否则 whichwhere 仍找不到命令。

text=ZqhQzanResources