perl-lsp在sublime中默认不工作，因lsp主插件不内置perl支持且无开箱即用的lsp-perl封装包；必须手动安装perl-language-server（npm全局）、严格匹配scopes为["source.perl"]、syntaxes为["packages/perl/perl.sublime-syntax"]，并禁用冲突插件。
Perl-LSP 在 Sublime Text 中能用，但默认不支持，必须手动配置语言服务器并绕过几个关键兼容性陷阱——否则 use strict 下的变量提示、sub 定义跳转、perldoc 悬停文档全都不会生效。
为什么 Perl-LSP 插件在 Sublime 里默认不工作
Sublime 的 LSP 插件（LSP 主包）本身不带 Perl 支持；社区也没有类似 LSP-pyright 那样开箱即用的 LSP-perl 封装包。你搜到的 “LSP-Perl” 多数是旧版废弃项目或 VS Code 专用扩展，直接安装会静默失败。
- Perl 语言服务器实际可用的是
perl-language-server（npm 包），不是perl-lsp或perl-server - 它依赖系统已安装的
perl可执行文件，且要求版本 ≥ 5.14；若用perlbrew或plenv管理多版本，必须确保perl-language-server启动时能访问到对应PERL5LIB和模块路径 - Sublime 不识别
.pl文件的默认语法作用域为source.perl，而新版perl-language-server要求scopes显式匹配source.perl，否则连接后立刻断开
安装 perl-language-server 并验证可执行路径
别用 cpan 装——它不提供 perl-language-server 的 CLI 入口；必须用 npm 全局安装，并确认 PATH 可达。
- 运行
npm install -g perl-language-server（需已安装 Node.js ≥ 14） - 终端执行
perl-language-server --version，输出类似v0.9.2才算成功 - Windows 用户注意：
command字段中路径必须用正斜杠，例如"command": ["perl-language-server", "--stdio"]，不能写成"perl-language-server.exe"或含空格路径 - macOS/Linux 若用
homebrew安装的 perl，可能因@INC缺失导致use warnings报错；建议加"args": ["--no-cwd"]避免工作目录污染
Sublime 中正确配置 LSP-perl 设置项
打开 Preferences → Package Settings → LSP → Settings，在 LSP.sublime-settings - User 中填入以下 JSON 片段，缺一不可：
{
"clients": {
"perl-language-server": {
"command": ["perl-language-server", "--stdio"],
"enabled": true,
"initializationOptions": {
"enableDocumentSymbols": true,
"enableSignatureHelp": true
},
"scopes": ["source.perl"],
"syntaxes": ["Packages/Perl/Perl.sublime-syntax"],
"languageId": "perl"
}
}
}
-
syntaxes必须精确匹配当前文件真实语法：按Ctrl+Alt+Shift+P查看底部显示，如果是Packages/Perl/Perl.sublime-syntax就对；若显示Packages/Perl/Perl.tmLanguage（旧版），需重装 Perl 语法包 -
scopes写成["text.perl"]或["source.pl"]都无效，只有source.perl被识别 - 若项目含
.pm模块文件，需额外在syntaxes中追加"Packages/Perl/Perl.sublime-syntax"（同一值，非不同路径） - 禁用其他 Perl 相关插件如
PerlTidy或SublimePerl，它们会劫持source.perl作用域，导致 LSP 启动失败
重构旧 Perl 脚本时的实操限制与替代方案
Perl-LSP 提供基础跳转和悬停，但不支持 Sublime 原生没有的语义级重构——比如把一段 foreach my $line (@lines) 提取为子程序，或跨文件重命名 $dbh 实例变量。
-
LSP: Rename只作用于当前文件，且仅当光标落在my $var声明处才触发；若在$var->method()调用处调用，会报No symbol found at location - 函数签名补全弱于 Python/TS：对
sub foo { my ($a, $b) = @_;能提示参数名，但对shift或pop风格无法推导 - 真正安全的变量重命名仍靠
Ctrl+D+ 正则：例如匹配\b\$user_id\b（注意\$转义），避免误改"user_id"字符串 - 模块依赖分析靠不住：LSP 不解析
use lib或PERL5LIB动态路径，use My::Util悬停常显示Not found；此时需手动在项目根目录放perl-ls.json配置"includePaths"
Perl-LSP 的价值不在“全自动”，而在让 perldoc -f open 这类查文档动作从终端切出变成悬停即得——这对维护十年以上的 CGI 脚本，比任何重构功能都实在。
