Sublime Text 默认不识别.cgi为Perl文件,需手动绑定扩展名:在用户设置中添加"extensions": ["pl", "pm", "t", "cgi"]和"syntax": "Packages/PerlImproved/PerlImproved.tmLanguage",并确保已安装PerlImproved插件。

Sublime Text 本身不识别 .cgi 文件为 Perl,直接打开会默认用 Plain Text 语法,导致无高亮、无缩进、括号不匹配、use strict 报错提示全无——这不是 Perl 写错了,是 Sublime 根本没把它当 Perl 解析。
为什么 .cgi 文件在 Sublime 里没有 Perl 高亮
Sublime 默认只把 .pl、.pm、.t 当作 Perl 文件,.cgi 不在内置识别列表中。它不会根据文件头(如 #!/usr/bin/perl)自动切换语法,也不会读取 MIME 类型或 shebang 行做判断。
- 右下角显示 “Plain Text” 或 “HTML” 是最常见现象
- 即使装了
PerlImproved插件,它也只扩展.pl/.pm支持,不自动接管.cgi -
selector字段(如"selector": "source.perl")只影响构建系统触发条件,和语法高亮无关
让 .cgi 文件自动用 Perl 语法高亮的两种可靠方式
推荐优先用第二种(用户设置绑定),更稳定、无需每次手动操作。
- 临时方案:打开
.cgi文件后,点击右下角语言名 → Open all with current extension as… → 选Perl。但下次重启 Sublime 或新建文件仍会重置 - 永久方案:在
Preferences → Settings – User中添加以下配置(注意 JSON 格式,逗号不能多也不能少):{ "extensions": ["pl", "pm", "t", "cgi"], "syntax": "Packages/PerlImproved/PerlImproved.tmLanguage" } - 若未安装
PerlImproved,先用Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜PerlImproved安装;安装后重启 Sublime 才能生效
运行 CGI 脚本前必须确认的三件事
CGI 脚本不是普通 Perl 脚本,Sublime 的构建系统默认不处理 Web 上下文,直接 perl $file 可能跑通但输出错乱(比如缺少 Content-Type 头)。
-
perl -c $file必须通过:先加-c参数校验语法,避免因use CGI缺失模块而静默失败 - 脚本开头必须有正确 shebang(如
#!/usr/bin/perl)且文件有可执行权限(Linux/macOS 下chmod +x script.cgi) - 不要依赖
Ctrl+B直接“运行 CGI”——它只是调命令行,不启动 Web 服务器。真要测试,用plackup或本地 Python HTTP 服务(python3 -m http.server --cgi 8000)更靠谱
容易被忽略的 CGI 开发细节
CGI 场景下,Sublime 的高亮和构建系统只是辅助,真正卡住人的往往是环境链路断点。
-
use CGI报错?说明系统 Perl 未装该模块。终端里运行cpan CGI或cpanm CGI安装,别指望 Sublime 自动解决 - 中文输出乱码?确保文件保存为 UTF-8 无 BOM,且脚本中加
binmode STDOUT, ":encoding(UTF-8)";和print "Content-Type: text/html; charset=utf-8\n\n"; - Sublime 底部面板显示
Can't locate CGI.pm?说明构建系统调用的是系统默认 Perl(比如 macOS 的/usr/bin/perl),但它没装模块;改用brew install perl后的 Perl(如/opt/homebrew/bin/perl),并在.sublime-build里写死路径
CGI 开发本身已趋于边缘,但一旦要维护旧系统,Sublime 配置的关键不在“怎么高亮”,而在“怎么让高亮不误导你”——比如 .cgi 文件里混着 HTML 片段时,PerlImproved 的高亮可能把 当成字符串字面量,这时得靠人眼判断,而不是信语法着色。

















