Sublime Text无法直接运行CGI脚本，所谓“配置”实为高亮、语法检查及本地模拟请求；需依赖真实Web服务器（如Apache、plackup）执行，错误排查须区分perl命令行与CGI运行环境差异。
perl 不是 Web 服务器，Sublime Text 也无法直接运行 CGI 脚本——所谓“配置 CGI 环境”，本质是让编辑器能正确高亮、语法检查、本地模拟请求，并把脚本丢给真实 CGI 容器（如 Apache、lighttpd 或 plackup）执行。你看到的“运行成功”，只是 Perl 解释器跑通了语法，不代表它真被当 CGI 调用。
为什么 perl -c 过得去，但浏览器访问返回 500？
CGI 脚本失败几乎从不报错在 Sublime 构建面板里，因为错误发生在 Web 服务器进程内，不是 perl 命令行执行阶段。常见原因包括：
-
print "Content-Type: text/html\n\n";缺少或没换行（必须两个\n） - 脚本权限不对：Linux/macOS 下没
chmod +x script.cgi，Web 服务器拒绝执行 - Web 服务器没启用 CGI 模块（Apache 需
a2enmod cgi，lighttpd 需mod_cgi） -
use lib或require的路径在 CGI 上下文里不可达（@INC和命令行不同） - STDERR 被 Web 服务器重定向到 error log，而 Sublime 构建系统根本看不到
file_regex 必须匹配 CGI 错误日志格式，否则点不了报错行
Apache 的 ErrorLog 默认格式是：[Sat Apr 26 05:42:13.123456 2026] [cgi:error] [pid 12345] [client ::1:56789] AH01215: syntax error at /var/www/cgi-bin/test.cgi line 8.
这个和 perl -c 的报错格式（test.cgi syntax error at line 8, near "..."）完全不同。Sublime 的 file_regex 只对构建输出生效，对 Apache 日志无效。
所以如果你真想在 Sublime 里跳转 CGI 错误行，得改用本地调试方式：
- 把 CGI 脚本开头加上
#!/usr/bin/perl -T和use strict; use warnings; - 终端里手动执行：
perl -c /path/to/script.cgi（语法检查） - 再执行：
SCRIPT_NAME=/test.cgi REQUEST_METHOD=GET perl /path/to/script.cgi（模拟 CGI 环境） - 把后一条命令写进
Build System的cmd字段，配合file_regex匹配标准 Perl 报错
CGI 脚本保存后自动用 plackup 启动轻量服务
比起配 Apache，用 Plack 搭 CGI 兼容层更可控，也方便 Sublime 直接调用。前提是已安装：cpan Plack CGI::Emulate::PSGI
新建一个 CGI-Plack.sublime-build：
{
"cmd": ["plackup", "-MCGI::Emulate::PSGI", "-s", "Starlet", "--port", "5000", "$file"],
"selector": "source.perl",
"working_dir": "$file_path",
"file_regex": "^(.*?):([0-9]+):?([0-9]+)?:? (.*)$"
}
注意几点：
-
plackup必须在 PATH 中；若不在，改用绝对路径（如["/home/user/perl5/bin/plackup", ...]） -
Starlet是支持热重载的轻量 HTTP 服务器，比默认的Standalone更适合开发 - 首次运行会卡住——这是正常的，服务已后台启动，浏览器访问
http://localhost:5000即可 - 下次修改保存后，按
Ctrl+B会重启服务（Starlet支持--reload，但需额外加参数）
中文路径、use 模块失败、$ENV{PATH} 为空这些不是 Sublime 的锅
Sublime 的构建进程继承的是**启动它的 shell 环境**，不是你 `.zshrc` 里 export 的变量。CGI 场景下尤其明显：
- 你在终端里
export PERL5LIB=/home/user/perl5/lib/perl5，但双击图标启动 Sublime → 它看不到这个变量 - 解决办法：在
.sublime-build里显式写"env": {"PERL5LIB": "/home/user/perl5/lib/perl5"} - CGI 脚本里
system("ls")失败？因为 Web 服务器清空了$ENV{PATH}，得在脚本里手动补：$ENV{PATH} = '/bin:/usr/bin'; - 中文路径下
$file展开成乱码？macOS/Linux 下优先用"shell_cmd": "perl \"${file}\" 2>&1"，Windows 则必须避免中文路径
最易被忽略的一点：CGI 脚本的 shebang 行（#!/usr/bin/perl）在 Sublime 构建中完全无用，它只影响 Web 服务器调用时的解释器选择；而 plackup 方式下，shebang 会被忽略，全靠你 cmd 里写的命令决定用哪个 perl。
