vscode能运行perl但需手动配置四要素：解释器路径、调试器、语言服务器和静态检查工具；缺一不可，否则语法不提示、断点不触发、perlcritic不报错、launch.json中program字段灰显。
VSCode 能跑 Perl，但默认啥都不干——必须手动配好解释器路径、调试器和语言服务器，否则连 print 都看不到输出，断点也进不去。
perl 命令找不到？先确认 PATH 和解释器位置
VSCode 的终端和调试器都依赖系统 PATH 中的 perl 可执行文件。很多人装了 Strawberry Perl 或用 perlbrew 管理版本，但 VSCode 启动时没读取 shell 的环境变量，导致报错 Cannot find perl executable 或直接闪退。
- 在终端里运行
which perl（macOS/Linux）或where perl（Windows），记下完整路径，比如/opt/homebrew/bin/perl或C:\Strawberry\perl\bin\perl.exe - 打开 VSCode 设置（
Cmd+,），搜索perl.executable，填入上面拿到的路径 - 如果用
perlbrew，别填perlbrew exec perl—— 调试器不认这种 wrapper，得填perlbrew root下真实的perl二进制路径，例如~/.perlbrew/perls/perl-5.38.2/bin/perl
launch.json 配置不对，断点永远不触发
VSCode 的 Perl 调试靠 perl-debug 扩展启动 perl -d，但 launch.json 里几个字段写错，脚本就只是“运行完就消失”，根本停不住。
-
"program": "${file}"是最常用写法，但若脚本依赖@ARGV或当前工作目录，得显式加"args"和"cwd"，例如："args": ["--verbose", "input.txt"]，"cwd": "${workspaceFolder}/scripts" -
"console": "integratedTerminal"比"internalConsole"更可靠，后者在 macOS 上常卡住输出 - 不要删掉
"type": "perl"和"request": "launch"—— 这俩是识别调试会话类型的硬性要求，缺一不可 - 如果脚本开头用了
#!/usr/bin/env perl，确保该 shebang 对应的 perl 和你配置的perl.executable一致，否则调试器可能加载错版本
没有 Perl::LanguageServer，就等于没智能提示
只装 Perl 扩展（rebornix 或 f4n0u4 版）只能高亮语法、匹配括号；真正要跳转定义、悬停看参数、补全模块函数，必须上 Perl::LanguageServer。
- 全局安装：
cpan install Perl::LanguageServer（不是cpanm，有些旧环境cpanm会漏依赖） - 在 VSCode 设置里搜
perl.languageServer.path，填入perl-language-server的绝对路径，例如/usr/local/bin/perl-language-server；如果which perl-language-server返回空，说明没装成功或不在 PATH，得重装 - 装完重启 VSCode，打开一个
.pl文件，底部状态栏应显示Perl LS: ready；若一直卡在starting...，大概率是perl-language-server启动时报错，可开 Output 面板选Perl Language Server查日志 - 对
DBI、JSON等常用模块，perl-langserver默认能解析 POD，但若悬停无文档，检查是否装了对应模块的perl-doc包（如 Debian/Ubuntu 上需apt install perl-doc）
perlcritic 和 perltidy 不是“装了就生效”
这两个工具装完后默认不自动运行，必须在设置里明确启用，且要注意它们对保存行为的影响。
-
perlcritic需在设置中开启perl.perlcritic.enable，同时建议设perl.perlcritic.standard为default或gentle，避免一存就报 50 行警告 -
perltidy开启perl.perltidy.enable后，它会在保存时覆盖原文件 —— 如果你习惯手调缩进或留空行，会被强制重排，建议先试perl.perltidy.options加-nbbc（不加空白行）和-pt=2（缩进 2 空格） - 两者都依赖
PERL5LIB环境变量加载自定义策略或配置文件，若项目有.perlcriticrc或.perltidyrc，得在launch.json或settings.json里通过"env"注入，否则只读全局配置
Perl 在 VSCode 里跑得顺不顺，关键不在“能不能”，而在“路径、服务、权限”三处是否对齐——少一个，print 就不出，use 就不补全，Ctrl+Click 就跳不到源码。这些地方藏得深，但改对一行配置，体验差十倍。
