VSCode中perl -v失败则CPAN模块必无法加载，因@INC路径未正确初始化；须先修复PATH使perl可执行，再验证@INC是否包含模块安装路径，否则use语句将报Can't locate XXX.pm。
perl -v 在 VSCode 终端里失败，CPAN 模块就不可能被找到
VSCode 本身不管理 Perl 模块路径，它只调用你系统里那个 perl 可执行文件；而这个可执行文件能否加载 CPAN 模块，完全取决于它启动时的 @INC（Perl 的模块搜索路径）。如果你在 VSCode 集成终端里运行 perl -v 都报 command not found，那后续所有模块引用——包括 use DBI;、require Test::More;——都会静默失败或直接报错 Can't locate XXX.pm in @INC。
常见诱因：
- macOS GUI 启动 VSCode 时没加载
~/.zshrc，导致brew安装的 perl 不在PATH - Windows 快捷方式启动 VSCode，PATH 里缺了
C:\Strawberry\perl\site\lib和C:\Strawberry\perl\vendor\lib - Linux 上用
perlbrew切换版本后，没在 VSCode 终端里执行perlbrew use perl-5.38.0
验证方式：在 VSCode 里按 Ctrl+` 打开集成终端，直接运行：
perl -MConfig -E 'say for @Config{@INC}'
输出的路径列表，就是当前 perl 实际搜模块的地方。如果里面没有你装模块的位置（比如 /home/xxx/perl5/lib/perl5），那模块就注定找不到。
perlbrew 用户必须显式激活，不能靠 shell 配置自动生效
perlbrew 不是环境变量注入工具，它是通过修改 PATH 和 PERL5LIB 来切换 Perl 环境的；但 VSCode 启动时往往不执行你的 ~/.bashrc 或 ~/.zshrc，所以即使你写了 source ~/perl5/perlbrew/etc/bashrc，VSCode 终端也大概率不会加载它。
解决方法只有两个，且必须二选一：
- 在 VSCode 集成终端里手动执行
perlbrew use perl-5.38.0（每次新开终端都要来一次） - 把
perlbrew的初始化脚本加到~/.zprofile（macOS）或~/.profile（Linux），然后**完全退出 VSCode 再重启**——否则旧进程不会重读 profile
验证是否生效：
which perl<br>perl -MConfig -E 'say $Config{archname}'
如果 which perl 还指向系统自带的 /usr/bin/perl，或者 archname 是 x86_64-linux-thread-multi 而不是你 perlbrew 安装版本对应的字符串，说明没切过去。
PadWalker 和 Devel::Debug 缺失会导致调试器无法显示变量
VSCode 的 Perl 调试器（比如 perl-debug 扩展）依赖两个底层模块才能读取运行时变量：PadWalker 提供栈帧变量访问能力，Devel::Debug（或更常见的 Devel::REPL 衍生模块）提供调试会话接口。缺任意一个，F5 启动后断点能停，但左侧“变量”面板永远空着，或者提示 No variables available。
安装命令要分环境：
- macOS/Linux（用
cpanm更稳）：cpanm PadWalker Devel::Debug - Windows Strawberry Perl：
cpan PadWalker Devel::Debug - Windows ActiveState：
ppm install PadWalker（Devel::Debug通常已内置）
注意：Devel::Debug 并非 Perl 标准模块，很多发行版默认不装；别只装 PadWalker 就以为万事大吉。装完后，在 VSCode 终端里跑：
perl -MPadWalker -MDevel::Debug -e1
不报错才算真正就位。
launch.json 中的 env 字段可临时补全模块路径
当全局 @INC 不可控（比如 CI 环境、多用户共享机器），又不想改系统级配置时，launch.json 的 env 字段是最小侵入的修复手段。它会在调试进程启动前注入环境变量，影响该次运行的 @INC。
例如你用 cpanm --local-lib ~/perl5 把模块装到家目录，可在 launch.json 的调试配置里加：
"env": {<br> "PERL5LIB": "/home/xxx/perl5/lib/perl5",<br> "PATH": "/home/xxx/perl5/bin:${env:PATH}"<br>}
关键点：
-
PERL5LIB会 prepend 到@INC开头，优先级最高 -
${env:PATH}是 VSCode 的变量语法，确保原有 PATH 不丢 - 不要写成
PERLLIB（旧版变量，已被弃用）
这个配置只对调试生效，不影响终端里直接 perl script.pl 的行为——这点常被忽略，导致你以为修好了，结果命令行跑还是报错。
