VSCode配置Perl开发环境需四步：确认系统perl可用且集成终端能运行perl -v；安装rebornix的Perl扩展并手动配置perl.perlPath；启用perlcritic检查并降级策略防卡顿；安装perl-debug扩展、Devel::Debug模块及正确配置launch.json。
VSCode 本身不带 Perl 运行时，所有功能（语法高亮、调试、perlcritic检查）都依赖外部 perl 可执行文件和正确配置的扩展链；缺任一环，launch.json 中的 program 字段会灰显，perlcritic 静默失效，断点无法命中。
确认系统 perl 解释器可用且路径明确
VSCode 集成终端必须能直接运行 perl -v。很多人只在系统终端验证成功，却忽略了 VSCode 启动方式（如从 Dock 或桌面图标启动）可能不加载 shell 的 PATH。
- macOS：用
brew install perl后，典型路径是/opt/homebrew/bin/perl；运行which perl确认，别抄网上的默认路径 - Windows：Strawberry Perl 路径通常是
C:Strawberryperlinperl.exe；ActiveState 则可能是C:Perlinperl.exe；注意反斜杠要写成双反斜杠C:\Strawberry\perl\bin\perl.exe在 JSON 里 - Linux：虽常自带 Perl，但 CentOS 7 默认是 5.16，
perlcritic会报兼容错误；建议用perlbrew装 5.30+，路径类似~/perl5/perlbrew/perls/perl-5.38.0/bin/perl - 在 VSCode 终端中执行一次
perl -v，失败就别往下配 —— 所有后续功能都会挂掉
安装 Perl 扩展并强制指定 perl.perlPath
rebornix 的 Perl 扩展只提供语法高亮和括号匹配，它不读取系统 PATH，也不自动探测解释器；不手动设 perl.perlPath，perlcritic 和格式化工具全部静默失效。
- 在扩展面板搜 “Perl”，装作者为
rebornix的那个（不是perl-debug或perl-langserver） - 按
Cmd+,（macOS）或Ctrl+,（Windows/Linux）打开设置，搜索perl.perlPath - 点击“在 settings.json 中编辑”，在顶层 JSON 对象里加这一行：
"perl.perlPath": "/opt/homebrew/bin/perl"（路径必须与which perl输出一字不差） - 别把它塞进
"[perl]"块里 —— 写错位置，VSCode 直接忽略该配置
启用 perlcritic 但避免卡顿
perlcritic 默认用最严策略（brutal），一开就让 VSCode 编辑器假死，尤其在含大量 POD 的模块里。它不是不能开，而是必须降级策略 + 显式指定可执行路径。
- 先在终端跑：
cpan install Perl::Critic；若卡住，加-f强制：cpan -f install Perl::Critic - 在
settings.json中启用并限策："perl.criticEnable": true，"perl.criticExecutable": "perlcritic"（别写绝对路径，除非你确定 PATH 里没它） - 追加策略降级项：
"perl.criticProfile": "--profile=~/.perlcriticrc"，并在家目录建.perlcriticrc，首行写severity = 3（跳过cosmetic和low级别） - 别信“保存即检查”宣传 —— 大项目下仍建议手动右键菜单选 “Run Perl Critic” 触发，避免后台持续扫描拖慢响应
调试必须配 perl-debug + launch.json + Devel::Debug
perl-debug 扩展（作者 rcjsuen）和原生 perl -d 不是一回事；它依赖 Devel::Debug 模块，且 launch.json 里的 perlPath 必须与 settings.json 中的 perl.perlPath 完全一致，否则断点不生效。
- 终端运行：
perl -MDevel::Debug -e 1；若报错，先cpan install Devel::Debug - 扩展市场搜 “perl-debug”，装
rcjsuen版本（不是gep13的旧版） - 按
⇧⌘P输入Debug: Open launch.json，选 Perl 模板，生成.vscode/launch.json - 确保配置里有这两项：
"program": "${file}"（支持当前文件调试），"perlPath": "/opt/homebrew/bin/perl"（值必须和settings.json里的一模一样） - 调试前务必在脚本里加一句
use strict; use warnings;—— 否则变量监视窗常为空，这是 Perl 动态作用域导致的常见盲区
最容易被忽略的是：VSCode 启动方式影响环境变量加载，以及 perl.perlPath 在 settings.json 中的位置错误。这两点不解决，后面所有调试和检查都只是看起来在工作。
