如何在VSCode中编写并运行Shell脚本？Bash开发环境配置【教程】

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 FilesGitbinbash.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 这三个命令养成习惯性敲一遍，比查十篇教程都管用。