Sublime Text Shell脚本开发最佳实践是：语法设为Bash、构建命令显式调用bash、缩进锁死Tabs

坦白说，Sublime Text 本身并不是一个开箱即用的 Shell 脚本开发环境。所以，所谓的“最佳实践”，核心不在于堆砌多少插件，而在于把三件基础但至关重要的事情做对：语法识别必须明确为 Bash（而非泛泛的 Shell Script），构建命令必须显式调用 bash 解释器（绕过权限依赖），缩进必须禁用自动检测并锁死为 Tabs。把这三点理顺，效率自然就上来了，其余大多是干扰项。

为什么 .sh 文件打开还是 Plain Text？必须手动绑定 Bash 语法

这里有个常见的误解：以为写了 #!/usr/bin/env bash 这个 shebang，Sublime 就会自动识别。其实不然，它主要看文件后缀和当前的语法设置。所以，即便你的脚本开头很标准，右下角如果显示的是 Plain Text 或 Shell-Unix-Generic，那么代码高亮、折叠、变量着色这些功能就全失效了。

• 首先，按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），调出命令面板，输入 Set Syntax: Bash 并回车。
• 如果列表里压根没有 Bash 选项，那说明还没安装官方的语法包。别急，再用命令面板执行 Package Control: Install Package，然后搜索 Bash（注意作者是 wbond，别选成 Bash-IDE 之类的），安装完成后重启一下 Sublime。
• 想一劳永逸？进入 Preferences → Settings – Syntax Specific，在右侧用户设置里加上这两行：

  {"extensions": ["sh"], "syntax": "Packages/Bash/Bash.sublime-syntax"}

Ctrl+B 运行报 Permission denied？别 chmod +x，改构建命令

遇到这个报错，先别急着怀疑自己的脚本逻辑。问题根源在于，Sublime 默认的构建系统会尝试以 ./script.sh 的方式直接执行文件，而 Unix 的权限机制会直接拦截没有执行权限的脚本。强行加个 chmod +x 反而掩盖了问题本质，而且不符合很多运维场景下的分发习惯（很多部署脚本本来就是靠 bash script.sh 来调用的）。

• 正确的解决路径是：打开菜单 Tools → Build System → New Build System…，新建一个构建系统文件。
• 把以下内容粘贴进去，然后保存为类似 Bash.sublime-build 的名字：

  {"shell_cmd": "bash -x \"$file\"", "file_regex": "^([^:]+):([0-9]+):?([0-9]+)?:? (.*)$", "working_dir": "$file_path", "selector": "source.shell"}

• 其中，"shell_cmd": "bash -x \"$file\"" 是核心关键：它显式调用 bash 解释器来执行脚本，完美绕过了文件权限检查。附带的 -x 参数会开启调试模式，每一步执行都会打印出来，这比脚本静默失败后再去排查要高效得多。
• 保存后，记得按 Ctrl+Shift+P 输入 Build: Select Build System，选中你刚刚创建的 Bash 配置。

Tab 缩进变成空格？Shell 脚本里制表符不是可选项

Shell 语言本身对缩进不敏感，但它对 if/then 这类语句的换行和分号位置却极其挑剔。Sublime 默认会把 Tab 键转换成空格，表面上看代码整齐划一，但实际上可能掩盖一些因 then 缺失换行或分号而导致的深层语法错误。

• 首先，执行 View → Indentation → Convert Indentation to Tabs，把文件中现有的空格缩进全部转换回 Tab。
• 接着，进入 Preferences → Settings – Syntax Specific，在右侧添加如下配置：

  {"detect_indentation": false, "tab_size": 4}

• 最后，确认 View → Indentation → Indent Using Tabs 处于勾选状态，并且 Tab Width 显示为 4。

输出一闪而过看不到错误？别加 read，改用重定向捕获

在构建命令后面追加 read 或 sleep 来暂停窗口，这只是权宜之计。我们真正需要的，是完整捕获脚本的标准输出（stdout）和标准错误（stderr）流，尤其是在进行 bash -n 静态语法检查或遇到 set -u 报未定义变量时，能看到完整的错误上下文。

• 一个更专业的做法是，修改构建命令为："shell_cmd": "bash -x \"$file\" 2>&1 | tee /tmp/subl-shell-log.txt"
• 这样，所有的执行输出和错误信息都会实时写入 /tmp/subl-shell-log.txt 这个文件，你可以随时用 tail -f 命令来跟踪查看，一目了然。
• 当然，如果脚本本身包含交互式命令（比如 read），那就不建议用 Build System 来运行了——直接切换到终端执行会更可靠。Sublime 此时更适合专注于编写和静态检查。

最后提一个最容易忽略的细节：上面所有的配置，其实都依赖于 selector 这个字段进行作用域匹配。安装了 Bash 语法包后，文件的作用域仍然是 source.shell，而不是 source.bash。因此，构建系统配置里的 "selector": "source.shell" 千万不要随意改动，否则你按 Ctrl+B 可能根本不会触发自定义的构建命令。