Sublime Text如何配置Shell脚本开发_Sublime Shell脚本开发配置攻略

Sublime Text 如何配置 Shell 脚本开发

如果你在 Sublime Text 里写 Shell 脚本，发现高亮不对、代码补全失灵，甚至按 Ctrl+B 压根没反应——先别急着怀疑自己的脚本语法。问题很可能出在编辑器本身：Sublime Text 默认就没把 .sh 文件当成真正的 Shell 脚本来处理。

怎么让 .sh 文件正确高亮？

看一眼编辑器右下角的状态栏。如果显示的是 “Plain Text” 或者 “Shell Script”，那都不算对。真正能完美支持现代 Bash 语法（比如 [[ ]] 条件判断、数组 ${arr[@]}、算术扩展 $(())）的，是 “Bash” 语法类型。Sublime 自带的 “Shell Script” 语法基于 POSIX，很多 Bash 特性它根本不认识，写对了也给你标成灰色，非常容易误导。

解决起来分几步：

• 首先，通过 Package Control 安装正确的语法包。用 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入 Package Control: Install Package，然后搜索并安装名为 Bash 的插件（注意作者是 wbond，别选成其他名称类似的）。
• 安装完成后，重启一下 Sublime Text。再打开你的 .sh 文件，点击右下角显示的语言名称（比如 “Plain Text”），在弹出的列表里选择 Bash。
• 这还没完，为了“一劳永逸”，还需要设置默认关联。点击菜单栏的 View → Syntax → Open all with current extension as…，然后选择 Bash。这样，以后所有 .sh 后缀的文件都会默认使用 Bash 语法进行高亮。
• 有个常见的误解：以为在脚本开头加上 #!/usr/bin/env bash（shebang）就能自动识别。其实不然，Sublime Text 基本不解析这行，它主要认文件后缀和你手动设置的语法类型。

Ctrl+B 没反应或报 No build system？

高亮正常了，但想运行脚本时，按 Ctrl+B 要么毫无动静，要么弹出一个 “No build system” 的错误。这同样不是脚本的错，而是 Sublime Text 没有为这类文件配置对应的“构建系统”。它不会因为你文件后缀是 .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"
}

• 这里有个关键点：配置里的 "selector": "source.shell" 必须和你文件当前的语法作用域匹配。即使你安装了 Bash 插件并设置了高亮，其底层作用域通常仍是 source.shell，而不是 source.bash。
• 保存好构建配置文件后，还需要激活它。再次按 Ctrl+Shift+P，输入 Build: Select Build System，然后从列表里选中你刚刚创建的 Bash。
• 最后，务必记得在运行前先按 Ctrl+S 保存你的脚本文件。如果文件处于未保存的临时缓冲区状态，$file 这个变量会是空的，构建命令自然会执行失败。

运行报 Permission denied 怎么办？

配置都做好了，一点运行，结果输出面板报错 “Permission denied”。这其实不是 Sublime Text 的 Bug，而是触发了 Unix/Linux 系统的基本权限规则。编辑器的构建系统本质上是在调用系统命令执行，它绕不过去对文件可执行权限（x）的检查。

可以按这个思路排查：

• 先在终端里用 ls -l your_script.sh 命令检查一下脚本文件的权限。你需要看到类似 -rwxr-xr-x 这样的输出，表示拥有可执行权限。
• 快速修复的方法是，在终端里对该文件执行 chmod +x your_script.sh。
• 或者，你也可以选择修改构建系统的命令，从根本上避开权限检查。把之前配置里的 "shell_cmd": "bash -x \"$file\"" 保持不变即可，因为这里是用 bash 解释器直接去“读取”脚本文件，而不是试图“执行”它（即不用 ./script.sh 这种方式），所以只需要文件有读（r）权限就行。
• 再次强调，不要指望脚本开头的 shebang（如 #!/bin/bash）能帮你自动解决这个问题。Sublime Text 的构建系统根本不理会 shebang，它只忠实执行你在 shell_cmd 里写的那条命令。

输出一闪而过、看不到错误？

有时候脚本似乎运行了，但 Sublime 底部的输出面板一闪即逝，特别是当脚本因语法错误或执行 exit 1 而提前退出时，你根本来不及看清错误信息。

这个问题可以这样应对：

• 核心在于利用调试信息。前面构建配置中使用的 bash -x \"$file\" 已经包含了 -x 参数，这会让 Bash 在运行每一行命令之前，先把这行命令打印出来。这相当于在整个脚本自动加上了 set -x，你能清晰地看到执行流程和出错的位置。
• 如果希望脚本运行完毕后暂停，以便查看输出，可以在脚本的末尾临时添加一行，比如 read -rp "按回车键继续..."。
• 对于更复杂的调试，可以将输出重定向到文件。把 shell_cmd 改成 bash -x \"$file\" > /tmp/shell-log 2>&1，这样所有输出（包括标准输出和错误）都会保存到 /tmp/shell-log 文件中，之后可以仔细查看。
• 如果脚本里的中文注释在输出面板显示为乱码，那可能是文件编码问题。去菜单栏选择 File → Reopen with Encoding → UTF-8，确保文件以 UTF-8 编码打开，而不是 GBK 或其他编码。

最后，最容易踩的坑是：语法高亮和构建系统在 Sublime Text 里是两套独立的机制。安装了 Bash 插件，只解决了代码着色的问题，并不代表按下 Ctrl+B 就能运行。反之，配置好了构建系统，如果语法没设置为 Bash，高亮依然可能是错的。所以，务必分别确认两件事：右下角显示的语言是 “Bash”，并且通过 Build: Select Build System 正确选中了你自定义的构建配置。两者缺一不可。