断点不命中八成因Perl解释器未被VSCode识别：需在集成终端验证perl -v成功，手动配置perl.perlPath为which perl真实路径且置于settings.json顶层，重启VSCode；安装Devel::Debug模块；动态加载代码需单步跟进而非直接打点。
断点不命中，八成是 Perl 解释器没被 VSCode 真正“看见”——不是插件没装，而是 perl.perlPath 没配对、没生效，或者 Devel::Debug 根本没装。
确认 perl 在 VSCode 终端里能跑通
别信系统终端里 perl -v 成功就万事大吉。VSCode 启动方式（尤其是 macOS GUI 或 Windows 快捷方式）常导致 PATH 不加载 brew/Strawberry 路径。
- 打开 VSCode，按
Ctrl+`（或Cmd+`）唤出集成终端，直接运行：perl -v - 如果报
command not found，立刻停手，别碰settings.json—— 先修环境： - macOS：在
~/.zshrc末尾加export PATH="/opt/homebrew/bin:$PATH"，然后完全退出 VSCode 再重开 - Windows：改用开始菜单中 “VS Code (Shell Command)” 启动，或确保快捷方式目标包含 shell 初始化逻辑
- Linux + perlbrew：确认
source ~/perl5/perlbrew/etc/bashrc已写入~/.bashrc，并在 VSCode 终端中执行perlbrew use perl-5.38.0测试
手动填对 perl.perlPath，且必须写在顶层
rebornix 的 Perl 扩展不读系统 PATH，也不猜路径。填错、位置错、不重启，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**——扩展只在启动时读这一项
装 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扩展（作者rcjsuen或felixfbecker，前者更轻量） - 项目根目录下创建
.vscode/launch.json，最小可用配置示例：
{
"version": "0.2.0",
"configurations": [
{
"type": "perl",
"request": "launch",
"name": "Perl Debug",
"script": "${file}",
"console": "integratedTerminal"
}
]
}
动态加载的代码（do/require/eval）断点不生效？这是 Perl 老项目的典型坑
Debugger 默认只监控主文件 ${file}。老系统常用 do 'config.pl'、require 'utils.pm' 甚至 eval $code，这些动态载入的代码根本不会被断点捕获。
- 不要把断点打在
do或require行上——它们只是加载动作；打在调用行之后，等它载入完再按F10单步跟进 - 对
eval里的代码，要么提前把字符串写成临时文件再do，要么直接切到命令行用perl -d script.pl验证逻辑 - 顺便检查脚本是否漏了
use strict或开了no warnings，语法错误被静默吞掉会导致 Debugger 连启动都失败，控制台里会刷Can't locate类报错
真正麻烦的从来不是配置步骤本身，而是环境变量、模块安装、路径写法这三者在不同系统上的微妙差异——尤其 macOS GUI 启动和 Windows 快捷方式这两类场景，最容易漏掉 PATH 加载，一卡就是半天。
