VSCode 完整支持 Perl 开发需配齐解释器、语言服务、调试适配器和静态检查工具四件套；缺一不可，否则 perlcritic 不报错、perl-debug 启不动、launch.json 中 program 字段灰显。
VSCode 能完整支持 Perl 开发，但必须手动配齐解释器、语言服务、调试适配器和静态检查工具四件套；缺任意一环，perlcritic 不报错、perl-debug 启不动、launch.json 里 program 字段会灰掉。
确认系统已安装 Perl 解释器并可被 VSCode 访问
VSCode 本身不带 Perl 运行时，所有功能都依赖外部 perl 可执行文件。若 perl -v 在终端报 command not found，后续所有配置都会失效。
- macOS 用户常用
brew install perl，路径通常是/opt/homebrew/bin/perl或/usr/local/bin/perl - Windows 用户若装的是 Strawberry Perl，典型路径是
C:\Strawberry\perl\bin\perl.exe；ActiveState Perl 则可能是C:\Perl\bin\perl.exe - Linux 用户多数自带 Perl，但版本可能过旧（如 CentOS 7 默认是 5.16），建议用
perlbrew管理多版本，路径类似~/perl5/perlbrew/perls/perl-5.38.0/bin/perl - 务必在 VSCode 终端中也运行一次
perl -v，确认 PATH 环境变量对集成终端生效 —— 很多人只在系统终端验证，却忘了 VSCode 启动方式影响环境变量加载
安装 Perl 扩展并正确设置 perl.perlPath
rebornix 的 Perl 扩展提供基础语法高亮与括号匹配，但它不包含调试能力，也不自动读取系统 PATH；必须显式指定解释器位置，否则 perlcritic 和格式化工具全部静默失败。
- 在扩展面板搜索
Perl，安装作者为rebornix的那个（注意不是perl-debug或perl-langserver） - 按
Cmd+,（macOS）或Ctrl+,（Windows/Linux）打开设置，搜索perl.perlPath - 点击“在 settings.json 中编辑”，添加键值对：
"perl.perlPath": "/opt/homebrew/bin/perl"（路径必须与which perl输出完全一致） - 该配置需写在
"[perl]"块外的顶层对象中，写错位置会导致设置被忽略
启用 perlcritic 语法检查但不卡 UI
perlcritic 是 Perl 最主流的静态检查工具，但默认配置极重，开箱即用容易让 VSCode 编辑器卡顿甚至假死，尤其在大项目或含 POD 文档的模块中。
- 先在终端运行
cpan install Perl::Critic安装核心模块；若失败，尝试cpan -f install Perl::Critic - 在 settings.json 中启用检查：
"perl.criticEnable": true，同时强制指定可执行路径："perl.criticExecutable": "perlcritic"（不推荐写绝对路径，除非 PATH 不稳定） - 关键一步：添加
"perl.criticArgs": ["--severity", "3"]，把默认的 level 5（最严）降到 3，避免大量低风险提示拖慢响应 - 如果仍卡顿，可在项目根目录加
.perlcriticrc文件，用only = ProhibitExcessComplexity等白名单方式收窄检查范围
配置 launch.json 实现可靠断点调试
Perl 调试依赖 perl-debug 扩展桥接 VSCode Debug Protocol 与原生 perl -d，但它的启动逻辑非常脆弱：路径错一位、引号少一对、字段名拼错，F5 就直接报 “Can’t find program”。
- 安装
perl-debug扩展（作者felixfbecker，非gep13那个已停更的） - 在项目根目录建
.vscode/launch.json，内容必须严格如下（注意逗号、引号、缩进）：
{
"version": "0.2.0",
"configurations": [
{
"type": "perl",
"request": "launch",
"name": "Perl Launch",
"program": "${file}",
"console": "integratedTerminal",
"perlPath": "/opt/homebrew/bin/perl"
}
]
}
-
perlPath必须与 settings.json 中的perl.perlPath完全一致；program推荐用${file}，不要硬编码脚本名 - 调试前确保当前打开的是
.pl文件，且光标不在注释或空白行 —— 否则断点图标不会变成实心红点 - 首次调试失败时，优先检查 VSCode 底部状态栏是否显示 “Perl Debug Adapter: Ready”；若显示 “Failed to launch”，大概率是
perlPath错误或缺少Devel::Debug模块（运行cpan install Devel::Debug补上）
真正麻烦的不是配置项数量，而是每个环节都存在「看起来成功、实际没生效」的隐性失败：比如 perlcritic 显示绿色对勾，但根本没扫描新写的代码；或者 launch.json 语法合法，却因工作目录不对导致 use lib 失效。这类问题往往要靠查看 VSCode 输出面板里的 Perl Language Server 或 Perl Debug 日志才能定位。
