离线配置Xdebug需联网时完成三项验证：php -v含xdebug字样、php --ini路径与编辑的php.ini一致、PhpStorm中显示Xdebug 3.x版本；并正确设置xdebug.mode=debug、xdebug.start_with_request=trigger、xdebug.client_host=127.0.0.1、xdebug.client_port=9003及绝对路径zend_extension；PhpStorm需配置匹配端口、服务器路径映射和监听状态，断点触发依赖URL参数?XDEBUG_SESSION_START=PHPSTORM且路径映射必须准确。
离线环境下配置 Xdebug 本质是「提前固化所有依赖」——Xdebug 扩展、php.ini 配置、PhpStorm 的端口与路径映射，三者必须在联网时全部验证通过；一旦断网，php 进程不会重载 ini，xdebug 不会重新加载，PhpStorm 也不会自动修正路径映射错误。
离线前必须验证的三项硬性条件
缺一不可，否则断网后调试必然失败：
-
php -v输出中必须含xdebug字样（不是只靠phpinfo()页面判断，因为页面可能缓存） -
php --ini显示的 Loaded Configuration File 路径，必须与你实际编辑的php.ini完全一致（常见坑：WAMP/XAMPP/PHPStudy 多个 php.ini 共存，改错文件） - 在 PhpStorm 中 Settings → PHP → Interpreter 页面右侧，必须明确显示
Xdebug 3.x.x（若写 “Not installed” 或空白，说明扩展未被识别，离线后无法补救）
Xdebug 3.x 离线配置要点（不兼容 Xdebug 2）
当前主流环境（PHP 7.4+）默认用 Xdebug 3，它的参数名和行为与旧版完全不同，混写会导致静默失效：
-
xdebug.mode=debug是开关，不能写on/true/1，也不能漏掉 -
xdebug.start_with_request=trigger表示仅在 URL 带XDEBUG_SESSION_START=PHPSTORM时启动，比autostart=1更可控，也更省资源 -
xdebug.client_host=127.0.0.1比localhost更可靠，避免 hosts 解析延迟导致连接超时（尤其 Windows） -
xdebug.client_port=9003是 Xdebug 3 默认端口，PhpStorm Debug 设置里必须填相同值，不能沿用旧教程的9000 - Windows 下
zend_extension必须用绝对路径，且双引号包裹，路径中反斜杠要转义或改用正斜杠：zend_extension="D:/php/ext/php_xdebug-3.1.5-8.1-vc15-x86_64.dll"
PhpStorm 离线调试配置关键动作
所有操作必须在联网时完成，并确认生效：
立即学习“PHP免费学习笔记（深入）”；
- Settings → PHP → Interpreter：选中已验证成功的 PHP 可执行文件（如
C:\php\php.exe），右侧显示 Xdebug 版本即为成功 - Settings → PHP → Debug：Xdebug port 填
9003（与php.ini中xdebug.client_port严格一致） - Settings → PHP → Servers：添加本地服务器，Host 填
127.0.0.1，Port 填 Web 服务端口（如80或8080），勾选 “Use path mappings”，然后手动把项目根目录映射到http://127.0.0.1/对应的绝对路径（例如D:\project\public→/） - Debug 配置模板（Run → Edit Configurations → Templates → PHP Web Page）中，Start URL 必须可访问（如
http://127.0.0.1/index.php），且 Validate 按钮点下去显示全绿对号
离线后唯一可用的触发方式
浏览器插件（如 Xdebug Helper）在断网时无法更新 IDE Key 或同步状态，所以最稳的方式是手动加参数：
- 在 URL 后追加
?XDEBUG_SESSION_START=PHPSTORM（注意大小写，必须与php.ini中xdebug.idekey完全一致） - 确保浏览器没缓存旧请求（可强制刷新
Ctrl+F5或用隐身窗口） - PhpStorm 右上角电话图标必须是绿色监听状态（
Start Listening for PHP Debug Connections），否则请求直接被丢弃 - 断点必须打在 PHP 文件真实路径上（不是浏览器看到的 URL 路径），且该文件已被 path mapping 正确关联
最容易被忽略的是 path mapping —— 离线时 PhpStorm 不会提示“未映射”，而是直接跳过断点，现象是：请求正常返回，但 PhpStorm 完全无响应。此时只能回退到联网环境，用 Validate 功能逐项检查映射是否准确。
