Xdebug在MAMP Pro中必须手动开启Debugger开关并配置xdebug.idekey="PHPSTORM"，否则PhpStorm无法接收调试请求；还需确保PhpStorm的Debug端口（9000）、Server路径与MAMP Pro完全一致，并通过?XDEBUG_SESSION_START=PHPSTORM触发调试。
Xdebug 在 MAMP Pro 里默认是关闭的，不手动开启 + 配置 IDE key，PhpStorm 根本收不到调试请求——哪怕所有端口、路径都对，也会一直“断点不命中”。
MAMP Pro 中必须勾选 Debugger 开关
这是最容易被跳过的一步：MAMP Pro 的 PHP 设置页（不是 php.ini）里，“Debugger”复选框默认是未勾选的。它控制的是底层是否加载 Xdebug 模块，和 php.ini 里的 xdebug.remote_enable=1 是两层开关，缺一不可。
- 打开 MAMP PRO → 切换到 PHP Tab
- 找到 “Debugger” 项，务必打勾（别信“已启用”的视觉错觉，一定要亲手点一下）
- 勾选后必须点击左上角 Save，再点击右上角 Restart Servers
- 重启后可访问
http://localhost:8888/MAMP/→ 点 “phpinfo()”，搜索xdebug确认模块已加载
php.ini 中必须显式设置 xdebug.idekey
MAMP Pro 自带的 php.ini 模板里，xdebug.idekey 这一项常为空或缺失。而 PhpStorm 默认用 PHPSTORM 作为会话标识，若 php.ini 不匹配，Xdebug 就会静默丢弃调试连接。
- 路径：
MAMP PRO → File → Edit Template → PHP → [你当前选中的 PHP 版本] php.ini - 滚动到底部，找到
[xdebug]区块（若无则手动添加） - 确保包含这行：
xdebug.idekey="PHPSTORM"（注意双引号不能少，大小写敏感） - 其他常用项如
xdebug.remote_port=9000、xdebug.remote_autostart=1通常已有，不用改；xdebug.remote_host在新版 Xdebug 3+ 已废弃，不要设 - 保存后再次重启服务器
PhpStorm 的 Debug port 和 Server 配置必须与 MAMP Pro 对齐
PhpStorm 的监听端口不是“随便填个 9000 就行”，它要和 MAMP Pro 实际使用的 Xdebug 协议端口完全一致；Server 配置则决定了 URL 路径映射是否正确，否则断点永远找不到文件。
立即学习“PHP免费学习笔记（深入）”；
- PhpStorm →
Preferences → Languages & Frameworks → PHP → Debug → Xdebug → Debug port：设为9000（Xdebug 3 默认端口；若你用的是旧版 Xdebug 2，也可能是9000，但需和 phpinfo 中显示的一致） - PhpStorm →
Preferences → Languages & Frameworks → PHP → Servers：添加新 Server
• Name：localhost
• Host：localhost
• Port：8888（MAMP Pro Apache 默认端口，非 80）
• Debugger：Xdebug
• Absolute path on the server：/Applications/MAMP/htdocs/your-project（必须和你在 MAMP Pro Hosts 里设的 Document Root 完全一致，包括末尾斜杠） - 检查
Run → Start Listening for PHP Debug Connections图标是否为绿色电话 —— 红色=没开监听，断点必失效
浏览器触发调试靠的是 XDEBUG_SESSION_START 参数，不是插件本身
Firefox 插件 “The easiest Xdebug” 或 Chrome 的 Xdebug Helper，本质只是帮你自动加一个 GET 参数或 Cookie。它们不工作，往往是因为参数名或值没对上 xdebug.idekey。
- 插件设置中 “IDE Key” 必须填
PHPSTORM（和 php.ini 里一致） - 手动测试最可靠：在浏览器地址栏当前 URL 后追加
?XDEBUG_SESSION_START=PHPSTORM，回车 - 如果此时 PhpStorm 弹出 “Incoming Connection” 对话框，说明链路通了；若无反应，优先检查 phpinfo 是否真有 xdebug、
xdebug.idekey是否拼错、监听是否开启 - Postman 调试同理：在 Params 里加
XDEBUG_SESSION_START=PHPSTORM，Header 不需要额外设
真正卡住人的地方，从来不是“怎么装”，而是 xdebug.idekey 值不一致、Debugger 开关被忽略、或者 Server 配置里的绝对路径漏掉一个子目录层级 —— 这三处一旦出错，整个调试链就断在无声无息之间。
