vscode中shell脚本不高亮需手动设置语言模式为shell script，并配置文件关联；运行失败常因缺少shebang、执行权限或解释器不匹配；推荐用内置终端执行，配合shellcheck静态检查提升健壮性。
Shell脚本在VSCode里不高亮？检查文件关联和语言模式
VSCode默认不会把 .sh 文件自动识别为 Shell 脚本，尤其当你新建空文件或后缀名不标准时（比如叫 deploy 没后缀），语法高亮就没了。这不是插件问题，是语言模式没对上。
- 右下角状态栏看当前语言模式，如果是
Plain Text或Unknown，点它 → 选Shell Script - 想永久生效：打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），搜Configure File Association for '.sh'，选shellscript - 如果用的是
.bash或自定义扩展名，同样在设置里加映射："files.associations": {"*.bash": "shellscript"}
运行脚本失败：Permission denied 或 command not found
写完保存就点右键“Run Code”？大概率报错。VSCode本身不执行 Shell 脚本，它只是调用终端；而 Linux/macOS 要求脚本有可执行权限，且路径、解释器声明必须正确。
- 缺
#!/bin/bash（或#!/usr/bin/env bash）第一行？加——否则系统可能用/bin/sh执行，导致[[、source等 Bash 特有语法报错 - 没给执行权限？终端里跑
chmod +x ./myscript.sh，再用./myscript.sh运行 - 直接按
F5调试？得先装ShellCheck和Bash Debug插件，并配置launch.json，否则只是弹个终端闪退
推荐的轻量运行方式：终端内执行，别依赖插件
多数场景根本不需要“一键运行”插件。VSCode 内置终端足够快，也更可控，还能看到真实环境变量和工作路径。
- 快捷键
Ctrl+`（反引号）呼出集成终端，确保当前目录是脚本所在路径 - 想快速执行当前编辑的脚本？终端里输
bash ./<code>当前文件名（不用 chmod，绕过权限检查） - 需要反复调试参数？改完保存后，在终端按
↑回溯上一条命令，Enter重跑，比点鼠标快得多 - 注意：插件如
Code Runner默认用sh而非bash，容易掩盖语法兼容性问题
ShellCheck 报错但脚本能跑？别忽略它
ShellCheck 是唯一靠谱的静态检查工具，它报的不是“语法错误”，而是“在某些 shell、某些环境、某些输入下会出错”的隐患。比如未加双引号的变量、未声明的变量、错用 = 而非 ==。
- 装 ShellCheck：macOS 用
brew install shellcheck，Ubuntu 用sudo apt install shellcheck - VSCode 安装官方
ShellCheck插件后，错误会直接标在编辑器里，悬停看解释 - 典型坑：
if [ $var = "ok" ]—— 当$var为空时变成[ = "ok" ]，语法崩；应写成[ "$var" = "ok" ] - 它不报错 ≠ 安全，尤其涉及用户输入、文件路径、通配符时，双引号和
set -u得手动加上
/bin/sh 实现不同而挂掉。别只盯着“能不能运行”，多看 ShellCheck 提示，少用插件隐藏细节。
