Perl调试失败主因是PATH未配置或launch.json路径错误：需确认where/which perl有输出，手动添加bin目录到PATH；runtimeExecutable须用双反斜杠绝对路径；动态加载代码需单步跟进；中文乱码应设"console": "integratedTerminal"。
Perl脚本在VSCode里根本没反应？先确认perl是否在PATH里
VSCode的Perl Debugger不会自动找你系统里装在哪，它只认perl命令能直接执行。很多人装了Strawberry Perl或ActivePerl，但没勾选“Add to PATH”，结果点调试就报错：Cannot find runtime 'perl' 或直接卡在“Starting debugger…”。
- 打开终端（CMD/PowerShell/Terminal），运行
where perl（Windows）或which perl（macOS/Linux）——必须有输出，且路径指向你期望的Perl版本（比如C:Strawberryperlinperl.exe） - 如果没输出，去Perl安装目录手动把
perlin和perlsitein加进系统PATH，重启VSCode - 别信“我双击脚本能跑”——那走的是文件关联，Debugger走的是shell环境变量
launch.json里perl路径写错？用绝对路径+args绕过所有歧义
VSCode默认用perl命令启动，但旧系统常依赖特定Perl版本（比如5.16）、特定@INC路径或-I参数。用runtimeExecutable硬编码路径比依赖PATH更稳。
- 在项目根目录建
.vscode/launch.json，关键字段这样写：
{
"version": "0.2.0",
"configurations": [{
"type": "perl",
"request": "launch",
"name": "Perl Debug",
"program": "${file}",
"runtimeExecutable": "C:\Strawberry\perl\bin\perl.exe",
"args": ["-I", "lib", "-I", "C:\legacy\perl\modules"],
"env": {"PERL5LIB": "C:\legacy\perl\modules"}
}]
}
runtimeExecutable必须是绝对路径，反斜杠要双写（Windows）；macOS/Linux用正斜杠即可args和env都支持，但args优先级更高，旧脚本常靠-I加载私有模块，别只靠PERL5LIB
断点不命中？检查脚本是否被eval或require动态加载
老Perl系统爱用do 'config.pl'、require 'utils.pm'甚至eval $code，Debugger默认只监控主文件${file}，这些动态载入的代码根本不会停。
- 把断点打在
do/require调用行之后——等它载入完再F10单步跟进 - 对
eval里的代码，要么提前把字符串写成临时文件再do，要么用perl -d命令行调试验证逻辑 - 确认脚本没用
no warnings或use strict缺失导致语法错误被静默吞掉——Debugger可能连启动都失败，看调试控制台里有没有Can't locate类报错
调试时中文乱码或路径含空格？别让cmd.exe当替罪羊
Windows下VSCode默认用cmd.exe跑Perl，而cmd对UTF-8支持差，又怕空格，旧系统脚本名或路径带中文/空格时，Debugger直接崩。
- 在
launch.json里加"console": "integratedTerminal"，强制走VSCode内置终端（它用PowerShell或Git Bash，对UTF-8和空格友好得多） - 如果必须用cmd，把路径全换成短文件名（
dir /x查PROGRA~1这类），或改用perl -S script.pl方式间接执行 - Perl本身要加
use utf8;和binmode STDOUT, ':encoding(UTF-8)';，否则Debugger输出窗口看到的还是问号
旧系统Perl调试真正的麻烦不在配置，而在那些没文档的goto跳转、全局变量污染、还有散落在各处的sub AUTOLOAD——Debugger能停住，不代表逻辑你真看得懂。
