VSCode默认不执行Shell脚本，点运行无反应是正常现象；需同时满足三条件：首行#!/usr/bin/env bash、chmod +x赋权、终端中执行./script.sh或bash script.sh。
VSCode 默认不执行 Shell 脚本，点右键“运行”或双击没反应是正常现象——它不是终端模拟器，也不自动加权限、不默认调用 bash。真正能跑起来，靠的是三件事对齐：#!/usr/bin/env bash、chmod +x、在终端里敲 ./script.sh 或 bash script.sh。
为什么 .sh 文件打开是 Plain Text，没有高亮和提示？
VSCode 不靠后缀自动识别语言，而是靠语言 ID 绑定。哪怕你保存为 deploy.sh，右下角显示 “Plain Text”，说明它根本没加载 Shell 语法支持。
- 点击右下角语言标签（如“Plain Text”），手动选 “Shell Script” 或输入
shellscript - 更彻底的解法：在
settings.json中加这一行："files.associations": {"*.sh": "shellscript"} - 别装 “Shell Format” 类插件来解决高亮——那是格式化工具，不改语言识别逻辑
- 如果仍无效，检查是否被其他插件干扰（比如某些 YAML 插件会劫持
.sh）
Code Runner 点一下就报错，比如 [[ not found 或 declare: command not found？
Code Runner 默认用 /bin/sh 执行 .sh 文件，而你的脚本用了 Bash 特有语法（[[ ]]、source、数组、$(( ))），/bin/sh 直接不认。
- 改
code-runner.executorMap设置：把shellscript对应值设为"bash -c 'cd $dir && $fullFileName'" - 更轻量稳妥的做法：不依赖 Code Runner，按
Ctrl+`呼出集成终端，直接敲bash script.sh——绕过权限、shebang、解释器路径所有歧义 - 若坚持用
./script.sh，必须提前chmod +x script.sh，且首行#!/usr/bin/env bash比#!/bin/bash更兼容不同系统路径
ShellCheck 提示一堆 “未声明变量”，但脚本明明能跑？
ShellCheck 默认按 POSIX sh 标准检查，对 $PWD、$UID 这类 Bash 内置变量标黄警告，不是 bug，是它不知道你目标环境是 Bash。
- 在 VSCode 设置里搜
shellcheck，找到ShellCheck: Shell选项，设为bash（不是sh或空） - 确保本地
shellcheck已安装：brew install shellcheck（macOS）、sudo apt install shellcheck（Ubuntu） -
#!/usr/bin/env bash开头 +ShellCheck: Shell设为bash，两者缺一不可，否则仍按 POSIX 检查 - 变量引用不加双引号（如
echo $PATH）会被标记为危险——word splitting 在含空格路径时必然崩溃，这是真问题，别忽略
调试时 F5 报错 “cannot find bashdb” 或直接卡住？
VSCode 自带调试器不支持 Bash，必须靠外部调试器 bashdb + bash-debug 扩展，而 bashdb 在 macOS 上难装、Linux 上常需编译，Windows 更不推荐折腾。
- 最稳的替代方案：用 Bash 自带的追踪模式——在终端里运行
bash -x script.sh，每行执行前打印展开后的命令，比图形断点更可靠 - 若坚持图形调试，必须装
bashdb（brew install bashdb/sudo apt install bashdb）和扩展rogalmic.bash-debug（注意不是已停更的le0pard.bash-debug） - 项目根目录加
.vscode/launch.json，内容至少包含"program"指向脚本路径、"env"补全必要变量（如PWD,HOME） - 别漏掉：脚本第一行必须是 shebang，且文件要有执行权限，否则
bashdb启动即失败
最容易被忽略的其实是 shebang 和权限的耦合关系：没 #!/usr/bin/env bash，bash script.sh 能跑但 ./script.sh 不能；没 chmod +x，./script.sh 必报 Permission denied——这两者不是“二选一”，而是“同时要”。
