BBEdit中PLS(Perl语言服务器)不生效如何开启调试排查故障？

一、独立验证PLS服务可用性（开启调试模式） #

不需要依赖编辑器，直接通过终端启动PLS并输出调试日志，先确认服务本身能否正常运行：

• 执行命令启动带日志的PLS服务：PLS_DEBUG_LOG=/tmp/pls_runtime.log pls
• 服务正常启动时终端会进入等待输入的常驻状态，不会立刻退出；如果启动后立刻崩溃、抛出模块加载相关报错，可直接判定故障出在PLS安装侧
• 服务常驻时，可手动构造一个存在明显语法错误的Perl测试文件，通过LSP标准输入输出触发诊断请求，查看/tmp/pls_runtime.log中的内容：如果日志中完整记录了请求接收、语法解析、错误诊断返回的全流程，说明PLS本身功能正常，故障在BBEdit侧；如果日志无记录或存在运行时报错，说明PLS安装存在问题。

二、针对当前环境的PLS安装问题修复 #

你之前强制安装IO::Async的操作是高概率故障点：

• M1芯片版本的macOS 12.x 系统自带Perl存在编译参数定制、权限限制问题，IO::Async安装时测试失败通常是依赖缺失或编译兼容问题导致，强制安装会跳过完整性校验，导致模块运行时异步IO逻辑异常，PLS依赖该模块处理LSP请求，异常时会静默崩溃，不会向外抛出可见报错。
• 先执行which pls确认PLS的安装路径，记录返回的绝对路径备用。
• 执行cpanm --reinstall IO::Async，不要添加--force参数，根据安装报错提示补全缺失的依赖（通常是测试模块或系统层的IO相关编译依赖），待IO::Async完整测试通过安装完成后，再执行cpanm --reinstall PLS重装PLS。
• 如果反复重装IO::Async始终测试失败，建议通过perlbrew安装独立的社区版Perl环境，在独立环境中安装PLS，避免系统Perl的兼容问题。

三、BBEdit侧配置排查 #

确认PLS本身运行正常后，再排查BBEdit侧的配置问题：

• BBEdit作为GUI应用，默认加载的PATH环境变量和终端PATH不一致，不要在LSP配置中填写pls作为启动命令，必须填写之前通过which pls获取到的PLS绝对路径，否则会出现编辑器找不到服务、静默启动失败的问题。
• 打开BBEdit内置控制台（菜单栏选择「窗口」-「控制台」），切换到Perl文件时查看控制台输出，如果存在「语言服务器连接超时」「启动路径不存在」类的提示，对应调整LSP配置中的路径即可。
• 如果控制台显示LSP连接成功，但代码中没有显示错误标记，检查Perl语言的偏好设置，确认「实时语法诊断」「LSP错误标记」类的开关已开启，部分版本的BBEdit默认不会自动开启LSP提供的诊断展示功能。

内容的提问来源于stack exchange，提问作者Timothy R. Butler