VSCode写Bash脚本需正确配置语言识别、执行环境与调试工具：设"files.associations": {"*.sh": "shellscript"}解决高亮；用bash而非sh执行避免语法报错；ShellCheck设为bash模式并安装shellcheck；调试前装bashdb、配launch.json及shebang+chmod+x。
VSCode 能写好 Bash 脚本，但默认状态几乎等于“裸奔”——没高亮、没检查、点运行没反应、调试报错找不到 bashdb。核心问题不在你不会写 Shell，而在 VSCode 没被正确“认领”为 Shell 开发环境。
为什么 .sh 文件打开是 Plain Text？
VSCode 不靠文件后缀自动识别语言模式，它依赖语言 ID 绑定。哪怕你保存为 deploy.sh，右下角显示 “Plain Text”，说明它根本没加载 Shell 语法支持。
- 点击右下角语言标签（如 “Plain Text”），手动选 “Shell Script” 或 “Bash”
- 更彻底的解法：在
settings.json中加一行："files.associations": {"*.sh": "shellscript"} - 别装 “Shell Format” 类插件来解决高亮——那是格式化工具，不改语言识别逻辑
- 如果仍无效，检查是否被其他插件干扰（比如某些 YAML 插件会劫持
.sh）
Code Runner 执行报错或行为异常
Code Runner 默认用 /bin/sh 执行 .sh 文件，而你的脚本很可能用了 [[ ]]、数组、source 等 Bash 特有语法，/bin/sh 直接报错或静默失败。
- 在设置中搜索
code-runner.executorMap，找到shellscript对应项，改成："shellscript": "bash -i -c 'source ~/.bashrc; $fullFileName'"（Linux/macOS） - 更轻量稳妥的做法：不依赖 Code Runner，按
Ctrl+`呼出集成终端，直接敲bash script.sh——绕过权限、shebang、解释器路径所有歧义 - 若坚持用
./script.sh，必须提前chmod +x script.sh，且首行#!/usr/bin/env bash比#!/bin/bash更兼容不同系统路径
ShellCheck 提示一堆“未声明变量”，但脚本明明能跑
ShellCheck 默认按 POSIX 标准检查，对 $1、$PWD 这类位置参数和环境变量标黄警告，不是 bug，是它不知道你目标环境是 Bash。
- 在脚本开头加
# shellcheck source=/dev/null可临时忽略某行；但更推荐配置全局模式 - 在 VSCode 设置里搜
shellcheck，找到ShellCheck: Shell选项，设为bash（不是sh或空） - 确保本地
shellcheck已安装：brew install shellcheck（macOS）、sudo apt install shellcheck（Ubuntu） - 变量引用不加双引号（如
echo $PATH）会被标记为危险——word splitting 在含空格路径时必然崩溃，这是真问题，别忽略
想断点调试，bashdb 总提示 “not found”
bashdb 是外部命令，VSCode 的 Bash Debug 插件只是个 UI 封装，它不自带调试器。报错本质是 PATH 里没有 bashdb，或版本不匹配。
- 先在终端执行
bashdb --version，确认已安装且可调用；Ubuntu/Debian：sudo apt install bashdb；macOS：brew install bashdb - 在
.vscode/launch.json中显式指定路径："bashdbPath": "/usr/bin/bashdb"（根据实际输出调整） - 调试前务必在脚本里加
#!/usr/bin/env bash，否则bashdb启动时可能 fallback 到sh导致断点失效 - 别指望它像 Python 那样自动进函数——Shell 调试粒度粗，断点只在语句级生效，
for循环体、if分支内需手动逐行点
最常被跳过的其实是 shebang 和执行权限这对组合：少一个，VSCode 就无法把文件和 Bash 解释器真正绑定起来，后续所有高亮、检查、调试都建立在沙上。别省那两秒，每次新建脚本第一件事就是写 #!/usr/bin/env bash，保存，再 chmod +x。
