vscode识别perl解释器需显式配置perl.perlpath路径，否则调试和运行均失败；必须在settings.json顶层设置绝对路径，重启vscode，并验证perl -mdevel::debug -e 1通过。

perl 解释器没被 VSCode 正确识别，是运行失败的最常见原因。不是装了 Perl 就自动能跑，VSCode 不读系统 PATH 的“默认行为”，必须显式告诉它 perl 在哪。

确认 perl 可执行文件路径并写进 settings.json

VSCode 启动时不一定加载你终端里的 PATH，所以即使 perl -v 在 iTerm 或 CMD 里能跑，VSCode 集成终端也可能报 command not found。

• 先在系统终端运行 which perl（macOS/Linux）或 where perl（Windows），拿到绝对路径，比如 /opt/homebrew/bin/perl 或 C:\Strawberry\perl\bin\perl.exe
• 打开 VSCode 设置（Cmd+, 或 Ctrl+, ），搜 perl.perlPath，点“在 settings.json 中编辑”
• 在顶层 JSON 对象里加这一行（不要嵌套在 "[perl]" 块里）：
  "perl.perlPath": "/opt/homebrew/bin/perl"
• 重启 VSCode —— 这步不能跳，扩展初始化依赖它

运行单个 .pl 文件：用终端手动执行最可靠

VSCode 没有“一键运行 Perl”的内置按钮，别指望右键菜单里有“Run Code”。最稳的方式是自己在集成终端里敲命令。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 确保当前打开的是 xxx.pl 文件
• 按 Ctrl+` 呼出集成终端，它会自动 cd 到当前文件所在目录
• 直接输入：perl ./xxx.pl（Linux/macOS）或 perl .\xxx.pl（Windows）
• 如果脚本报错 Can't locate XXX.pm，说明 @INC 缺路径，临时加可以用：perl -Ilib ./xxx.pl

launch.json 里 program 字段灰显？检查两个硬性条件

program 字段变灰，代表 VSCode 根本没认出这是个 Perl 调试配置，通常卡在这两处：

• 没装 perl-debug 扩展（注意：不是 Perl 主扩展，是另一个独立扩展，作者通常是 felixfbecker 或 gep13）
• launch.json 里 "type": "perl" 这一行存在，但 VSCode 找不到匹配的调试适配器 —— 根源还是 perl.perlPath 没配对，或者 perl 本身不带 Devel::Debug
• 验证调试模块是否就位：终端执行 perl -MDevel::Debug -e 1，不报错才算通过
• 最小可用 launch.json 配置中，"program" 必须用 ${file}，不能写死路径；"console" 推荐设为 "integratedTerminal"，避免弹黑窗

perlcritic 不报错？别急着调参数，先看它有没有真启动

很多人开了 "perl.criticEnable": true 却看不到任何提示，其实是 perlcritic 根本没跑起来。

• 先在终端运行 perlcritic --version，确认命令可用；若报错，用 cpan install Perl::Critic 装
• VSCode 设置里 "perl.criticExecutable" 必须填 "perlcritic"（字符串，不是路径），除非你的 PATH 不稳定才写绝对路径
• 它只检查当前打开的文件，且默认只报告“brutal”及以上级别问题；想看到更多，得加配置："perl.criticProfile": "~/.perlcriticrc"，并确保该文件存在且含 severity = 1
• 大文件或含大量 POD 的模块会让 perlcritic 卡住 UI，这不是 bug，是它默认策略太重 —— 真要实时反馈，得自己裁剪规则集

perl.perlPath 配错、perl-debug 扩展漏装、Devel::Debug 模块缺失 —— 这三者任一出问题，都会让“运行”和“调试”同时失效。它们不是可选优化项，是 Perl 在 VSCode 里能动起来的底层契约。