VSCode不自带Shell解释器,依赖系统bash等shell;Windows需启用WSL或安装Git for Windows,macOS/Linux默认有bash;需配置默认终端为bash、添加脚本执行权限(chmod +x)、推荐安装Bash Debug和ShellCheck插件。

VSCode 本身不自带 Shell 解释器,运行脚本依赖系统已安装的 bash(或其他 shell),配置重点是让编辑、调试、执行流程顺滑,而不是“装个插件就自动跑起来”。
安装 Bash 并确认可用
VSCode 只是编辑器,真正执行脚本的是操作系统里的 shell。Windows 用户必须先启用 WSL 或安装 Git for Windows(附带 bash.exe);macOS 和 Linux 默认已有 /bin/bash。
- 终端中运行
bash --version,确保输出版本号 - Windows 上若用 Git Bash,路径通常是
"C:\Program Files\Git\bin\bash.exe",需加入系统PATH - VSCode 的集成终端默认继承系统环境,如果
which bash报错,说明终端根本没找到bash,后续所有运行都会失败
设置 VSCode 的默认终端为 Bash
避免在 PowerShell 或 cmd 里误执行 ./script.sh 导致权限错误或语法报错。
- Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS)→ 输入
Terminal: Select Default Profile - 选择
Git Bash(Windows)、bash(macOS/Linux)或WSL Bash - 重启终端:关闭现有终端窗口,再 Ctrl+` 新开一个,输入
echo $0应返回bash
给 Shell 脚本添加可执行权限并运行
Linux/macOS 下直接 ./script.sh 失败,99% 是因为缺少执行权限;Windows(Git Bash/WSL)同样遵循该规则。
- 在文件所在目录打开集成终端,运行:
chmod +x script.sh
- 然后执行:
./script.sh
- 如果提示
Permission denied,别急着改 VSCode 设置——先检查ls -l script.sh看权限位是否含x - 也可绕过权限,用解释器显式调用:
bash script.sh
(此时不依赖x位,适合快速测试)
推荐安装的插件与配置项
纯写脚本可以不用插件,但以下三项能显著减少低级错误:
- 安装
Bash Debug插件(Microsoft 官方):支持断点、变量查看,需配合bashdb(sudo apt install bashdb或brew install bashdb) - 启用
shellcheck:VSCode 安装ShellCheck插件后,自动标出未加引号的变量、未声明的变量等隐患 - 在
settings.json中加一行,避免保存时意外删掉末尾空行(Shell 脚本有时依赖它):"files.insertFinalNewline": false
真正卡住人的往往不是语法,而是权限、终端类型、解释器路径这三处;把 which bash、ls -l、echo $0 这三个命令养成习惯性敲一遍,比查十篇教程都管用。










