VSCode集成终端中perl -v必须成功，否则所有后续功能失效；需先在终端验证并修复PATH，再手动配置perl.perlPath到settings.json顶层并重启VSCode。
perl -v 在 VSCode 集成终端里必须成功
所有后续操作（运行、调试、perlcritic）的前提是：VSCode 自己的终端能认出 perl。不是你在 iTerm 或 CMD 里跑通了就算数——GUI 启动的 VSCode（macOS Dock / Windows 快捷方式）往往不加载 shell 的 PATH。
打开 VSCode，按 Ctrl+` 呼出集成终端，直接敲：
perl -v
如果报 command not found，别急着改配置，先修环境：
- macOS：在
~/.zshrc末尾加export PATH="/opt/homebrew/bin:$PATH"，然后完全退出 VSCode 再重开 - Windows：用“VS Code (Shell Command)”从开始菜单启动；或右键快捷方式 → 属性 → 目标栏补上
shell:startup类参数（更稳的是用 Chocolatey 安装） - Linux +
perlbrew：确认source ~/perl5/perlbrew/etc/bashrc已写入~/.bashrc，并在 VSCode 终端里执行perlbrew use perl-5.38.0测试
perl.perlPath 必须写对、写准、写顶层
rebornix 的 Perl 扩展不读系统 PATH，也不猜路径。填错、写错位置、不重启，perlcritic 静默失效、launch.json 中的 program 字段直接灰显。
操作步骤：
- 先在终端跑
which perl（macOS/Linux）或where perl（Windows），拿到真实路径，例如/opt/homebrew/bin/perl或C:\Strawberry\perl\bin\perl.exe（注意 Windows 反斜杠必须双写） - 按
Cmd+,（macOS）或Ctrl+,（Windows/Linux）打开设置，搜perl.perlPath，点“在 settings.json 中编辑” - 把这行粘贴进 JSON 文件最外层大括号内（不是嵌套在
"[perl]"块里）："perl.perlPath": "/opt/homebrew/bin/perl" - 保存后必须重启 VSCode——扩展初始化只在启动时读这一项
安装模块要用 cpan，但得看清楚在哪装
VSCode 不会帮你自动装模块。你装的位置，必须和它调用的 perl 是同一个解释器，否则 use ModuleName 仍会报 Can't locate。
验证和安装方法：
- 先在 VSCode 集成终端里运行
perl -MDevel::Debug -e 1，失败就说明调试模块没装，要cpan install Devel::Debug - 同理，
perlcritic是独立命令，需cpan install Perl::Critic；若卡住，加-f强制：cpan -f install Perl::Critic - 调试时变量面板为空？大概率缺
PadWalker：cpan install PadWalker（Windows 上用ppm install PadWalker如果用 ActiveState） - 所有
cpan命令都必须在 VSCode 集成终端里执行，确保走的是你刚配好的那个perl
运行脚本不能只靠右键 Run Code
Code Runner 插件一键运行很省事，但它默认用 perl 命令，不读你的 perl.perlPath，也不传参、不进调试模式。真要跑，还是得靠 VSCode 原生能力。
推荐做法：
- 创建
.vscode/launch.json，最小可用配置如下：
{
"version": "0.2.0",
"configurations": [
{
"type": "perl",
"request": "launch",
"name": "Perl Launch",
"program": "${file}",
"console": "integratedTerminal"
}
]
}
保存后，打开一个 .pl 文件，按 F5 就能运行并调试。注意：program 字段灰显？说明 perl.perlPath 没生效或没重启。
真正容易被忽略的是：模块安装路径和 perl 解释器绑定太紧。换一个 perlbrew 版本、切一个 Strawberry Perl 架构（32/64bit）、甚至 macOS 升级后 brew 路径变动，都可能导致已装模块突然“消失”。每次换环境，第一件事不是改配置，而是进 VSCode 终端重新跑一遍 perl -v 和关键模块的 -M 测试。
