Sublime中Perl构建系统失效的根源是perl -v在终端不可执行，需确保PATH正确配置并用终端启动Sublime；Build System必须为JSON格式且语法精准，cmd首项为"perl"，file_regex匹配Perl报错格式，selector设为source.perl，并通过shell_cmd捕获STDERR解决warn/die不显示问题。
不能直接运行，必须依赖系统已安装的 Perl 解释器；Build System 配置错一个字符（比如少逗号、引号不闭合）就静默失败，且不会报错提示。
perl -v 能否在终端执行是唯一前提
所有配置失效的根源几乎都卡在这步。Sublime 的 Build System 本质是调用 shell 命令，如果 perl -v 在你当前终端里报 command not found 或 'perl' is not recognized，那 Sublime 永远不会成功。
- macOS/Linux：运行
which perl，输出为空？检查~/.zshrc或~/.bash_profile是否把 Homebrew 安装路径（如/opt/homebrew/bin）加进了PATH - Windows：运行
where perl，没结果？重装 Strawberry Perl 并务必勾选「Add to PATH」；若已装好，重启命令行再试 - Sublime 启动方式影响环境变量：从桌面图标启动的 Sublime 可能读不到你改过的
PATH；改用终端执行subl启动编辑器，才能继承当前 shell 环境
Perl.sublime-build 必须用 JSON 格式精准写
菜单 → Tools → Build System → New Build System…，粘贴以下内容并保存为 Perl.sublime-build（扩展名不能错）：
{
"cmd": ["perl", "$file"],
"file_regex": "^(.*?):([0-9]+):?([0-9]+)?:? (.*)$",
"selector": "source.perl",
"encoding": "utf-8"
}
-
"cmd"数组第一项必须是"perl"，不是脚本路径；只有which perl返回空时才需填绝对路径（如"C:\Strawberry\perl\bin\perl.exe"） -
"file_regex"必须匹配 Perl 默认报错格式，例如test.pl line 12.或test.pl:15: syntax error；否则点击错误不会跳转到对应行 -
"selector": "source.perl"意味着：右下角状态栏必须显示 “Perl”，不是 “Plain Text”；可按Ctrl+Shift+P输入Set Syntax: Perl手动切换
中文路径、warn/die 不显示、乱码问题怎么解
默认构建只捕获 STDOUT，warn 和 die 输出到 STDERR，Sublime 默认不显示——所以脚本崩了却没报错，非常常见。
- 临时验证：在脚本开头加
use warnings; use strict;，让问题提前暴露在语法阶段 - 强制捕获 STDERR：把
"cmd"改成"shell_cmd": "perl "$file" 2>&1"（仅 macOS/Linux 可靠；Windows 用户若报错，退回"cmd"并确保 Perl 路径不含空格） - 中文路径报
No such file or directory：Sublime 的$file不做 shell 转义；最快验证方式是把脚本移到纯英文无空格路径下（如~/code/test.pl） - 中文输出乱码：脚本用 UTF-8 保存，但 Windows 控制台默认 GBK；最稳方案是避免中文路径 + 统一用 UTF-8 + 不依赖系统 locale
CGI 脚本别指望 Sublime 直接“运行”
Sublime 无法模拟 Web 服务器环境，所谓“运行 CGI”只是调用 perl script.cgi 做语法检查或命令行执行，和真实 CGI 行为完全不同。
-
perl -c过得去 ≠ 浏览器访问不报 500；常见原因包括：print "Content-Type: text/html ";缺少换行、Linux/macOS 下没chmod +x、Web 服务器未启用 CGI 模块 - 想本地调试 CGI 行为：在终端手动模拟环境变量，例如：
SCRIPT_NAME=/test.cgi REQUEST_METHOD=GET perl /path/to/script.cgi - 把这个命令写进 Build System 的
"cmd"字段，并配好"file_regex"，才能让错误定位生效
最容易被忽略的是：Sublime 的 Build System 对 JSON 语法极其敏感，一个多余逗号、漏掉引号、中文标点混入，都会导致静默失败——它不会弹窗报错，也不会输出任何提示，只是按 Ctrl+B 后毫无反应。建议先用最小配置验证，再逐步加 shell_cmd、env 等字段。
