VSCode完整支持Perl开发需配齐解释器、语言服务、调试适配器和静态检查工具四件套；缺一不可，否则perlcritic不报错、perl-debug启不动、launch.json中program字段灰显。
VSCode 本身不运行 Perl 代码，它只是调用你系统里已安装的 perl 可执行文件；如果 perl -v 在 VSCode 集成终端里报错，那所有后续操作（语法检查、调试、格式化）都会静默失败。
确认 perl 解释器在 VSCode 终端中可用
很多人只在系统终端验证了 perl -v，却忽略了 VSCode 启动方式会影响环境变量加载 —— 尤其是 macOS GUI 启动或 Windows 快捷方式启动时，PATH 往往不包含 brew 或 Strawberry 的 bin 目录。
- 打开 VSCode，按
Ctrl+`（或Cmd+`）唤出集成终端，直接运行perl -v - 若提示
command not found，不要改settings.json，先解决环境：macOS 用户可在~/.zshrc中补全export PATH="/opt/homebrew/bin:$PATH"并重启 VSCode；Windows 用户检查快捷方式是否以管理员身份运行，或改用开始菜单中“VS Code (Shell Command)”启动 - Linux 用户若用
perlbrew，确保source ~/perl5/perlbrew/etc/bashrc已写入 shell 配置，并在 VSCode 终端中执行perlbrew use perl-5.38.0测试
安装 Perl 扩展并强制指定 perl.perlPath
rebornix 的 Perl 扩展只提供语法高亮和括号匹配，它不会自动读取系统 PATH；不手动配置 perl.perlPath，perlcritic 不报错、保存格式化不触发、launch.json 中的 program 字段会灰显不可编辑。
- 在扩展市场搜索
Perl，安装作者为rebornix的那个（别选perl-debug或perl-langserver） - 按
Cmd+,（macOS）或Ctrl+,（Windows/Linux）打开设置，搜perl.perlPath，点击“在 settings.json 中编辑” - 添加顶层键值对：
"perl.perlPath": "/opt/homebrew/bin/perl"（路径必须与which perl输出完全一致；Windows 要写双反斜杠："C:\Strawberry\perl\bin\perl.exe"） - 该配置不能放在
"[perl]"块内，否则会被忽略
用 launch.json 启动调试前先装 Devel::Debug
perl-debug 扩展依赖 Perl 自带的调试模块，但很多发行版（尤其是 ActiveState 和部分 perlbrew 构建）默认不启用 Devel::Debug，导致断点命中后变量面板为空、单步执行卡死。
- 在 VSCode 集成终端中运行：
perl -MDevel::Debug -e 1；若报错Can't locate Devel/Debug.pm，则需手动安装：cpan install Devel::Debug - 安装
perl-debug扩展（作者felixfbecker或rcjsuen，两者都可，但前者更轻量） - 项目根目录下创建
.vscode/launch.json，最小可用配置如下：
{
"version": "0.2.0",
"configurations": [
{
"type": "perl",
"request": "launch",
"name": "Perl Launch",
"program": "${file}",
"console": "integratedTerminal"
}
]
}
注意：program 字段值必须是文件路径（如 "${file}"），不能是命令字符串（如 "perl ${file}"）；否则调试器启动即退出。
perlcritic 卡顿不是配置错了，是规则太重
开箱启用 perlcritic 后编辑器假死，大概率不是路径问题，而是默认策略（brutal 级别）扫描整个文件（含 POD 文档块）并做符号解析，对 >500 行的 .pm 模块尤其明显。
- 先确保已运行：
cpan install Perl::Critic（cpan -f强制重装可绕过依赖冲突） - 在
settings.json中启用检查："perl.criticEnable": true，同时指定可执行路径："perl.criticExecutable": "perlcritic"（不建议写绝对路径，除非PATH不稳定） - 加一行降级配置：
"perl.criticProfile": "--profile $HOME/.perlcriticrc"，并在~/.perlcriticrc中写入：severity = 3（只报中等及以上问题） - 若仍卡顿，临时禁用 POD 检查：
only = Subroutines::ProhibitExplicitReturnUndef（挑几个关键规则白名单式启用）
最容易被忽略的一点：VSCode 的 Perl 支持是“拼装式”的 —— 解释器、语言服务、调试适配器、静态检查工具四者缺一不可，且任意一个路径写错（比如多一个空格、少一个斜杠、用了中文引号），对应功能就彻底失效，但 VSCode 不报错也不提示，只会静默跳过。
