Sublime Text配置Shell脚本开发与运行调试环境

Sublime Text配置Shell脚本开发与运行调试环境

先说一个核心事实：Sublime Text 本身并不运行 Shell 脚本，它只是一个调用系统 shell 的“传令兵”。 脚本能否顺利跑起来，关键不在于语法高亮是否配对了，而在于构建系统是否正确传递了参数、文件权限是否到位、以及工作目录是否匹配脚本的依赖关系。

为什么 Ctrl+B 没反应或报 “No build system”

遇到这种情况，先别急着怀疑自己的脚本逻辑。问题根源往往是 Sublime Text 根本没有绑定相应的构建规则。它可不会因为文件开头写了 #!/bin/bash 就自动启用某个构建命令——shebang 在这里是完全被忽略的。

要解决这个问题，得按顺序检查几个地方：

• 首先，看一眼编辑器右下角的状态栏，必须显示为 ShellScript 或 Bash。如果没显示，建议安装一个 Bash 插件，并手动将 .sh 后缀文件关联到此语法。
• 接着，从菜单栏进入 Tools → Build System → New Build System…，新建一个构建系统文件，保存为 Shell.sublime-build。这个文件会自动保存在 Packages/User/ 目录下。
• 还有一个容易踩的坑：文件必须保存。在未保存的临时缓冲区里，$file 变量会是空字符串，shell_cmd 命令自然执行失败。
• 最后，按 Ctrl+Shift+P 调出命令面板，输入 Build: Select Build System，确保当前选中的是你刚刚创建的那个构建系统，而不是 Automatic。

Permission denied 错误怎么绕过或修复

看到“Permission denied”报错，十有八九是脚本文件本身缺少执行权限，这跟构建配置本身关系不大。因为 Sublime Text 的构建系统底层是调用 system() 函数，绕不过 Unix 系统的权限检查。

可以按照这个思路排查：

• 打开终端，运行 ls -l script.sh，确认文件权限中包含 x（例如显示为 -rwxr-xr-x）。
• 快速修复方法是直接赋予执行权限：chmod +x script.sh。
• 更稳妥的做法是修改构建配置：别用 ./$file 这种方式，改用 bash "$file" 或 sh "$file"。这样一来，解释器直接读取文件内容执行，只依赖读权限，完全跳过了对执行位的检查。
• 需要警惕的是，别指望写了 #!/usr/bin/env bash 就能自动运行。Sublime Text 不解析 shebang，它只认构建配置里 shell_cmd 这一条命令。

输出一闪而过或看不到错误信息

这是新手常遇到的困惑：脚本好像执行了，但 Sublime 构建面板的输出一闪即逝，什么信息都看不到。其实，这是因为构建面板默认不会保持终端状态，尤其当脚本正常结束或未触发明确错误时，输出内容会立刻被清空。

想让输出“停”下来，有几个办法：

• 在构建命令 shell_cmd 的末尾，加上 && read -p "Press Enter to exit"（适用于 Linux/macOS），这样执行完后会等待用户按回车。
• 或者，将输出重定向到日志文件：bash "$file" > /tmp/sublime-run.log 2>&1，然后手动去查看日志内容。
• 尽量避免使用像 gnome-terminal -- bash -c "..." 这类方案。它虽然会新开一个终端窗口，但却与 Sublime 的构建面板脱节，导致无法捕获脚本的退出状态码或标准错误流。
• 如果脚本需要交互（比如使用 read 命令等待输入），默认的构建系统是不支持 stdin 输入的。这时要么改用 Terminus 这类插件，要么干脆回到终端手动运行。

working_dir 和路径变量怎么写才不崩

脚本里明明写了 ./config.json 或 source ./lib.sh，运行时却提示找不到文件？这大概率是 working_dir（工作目录）没设置对，导致相对路径的基准点错了。

配置路径变量时，记住这几个要点：

• 必须设置 "working_dir": "$file_path"，而不是 "$file" 或留空。留空会导致脚本在 Sublime Text 的安装目录下执行，那当然找不到你的项目文件。
• 区分好变量：$file_path 是文件所在的目录路径，结尾不带斜杠；$file_name 是纯文件名，不包含路径。
• 如果路径包含空格，shell_cmd 里所有变量都必须用双引号包裹，例如 "bash \"$file\""，否则 shell 解析时会把路径从空格处断开。
• 对于 Windows 用户，别强行配置原生 cmd。shebang 在 cmd 下无效，#!/bin/bash 会直接报错。使用 WSL 的用户，建议采用 bash -c "cd '$file_path' && '$file'" 这种方式来构建。

最后，再强调一个最常被忽略的要点：构建系统要生效，必须同时满足三个前提——文件已保存、语法已手动设为 Bash/ShellScript、构建系统已手动选中。三者缺一不可。Sublime Text 不会做任何猜测，它只会一丝不苟地执行你明确告诉它的那条命令。