能跑起来、能调试、不报错的三步核心是：1. 手动指定PHP解释器路径并验证版本；2. 配置服务器映射，勾选Use path mappings并正确关联项目根目录与Web根目录；3. 统一Xdebug client_port（9003）与PhpStorm监听端口，启用xdebug.mode=debug并开启IDE监听。
能跑起来、能调试、不报错，三步到位——不是所有配置都必须做，但以下三步缺一不可。
PHP解释器路径必须手动指定
PhpStorm 不自带 PHP，php.exe 或 php 可执行文件路径必须明确指向本地安装位置。常见错误是点“Auto-detect”后选错版本，或路径含中文/空格导致加载失败。
- Windows 典型路径：
C:\php\php.exe（绿色版）、D:\phpstudy_pro\Extensions\php\php_8.1.10\php.exe（phpStudy）、C:\xampp\php\php.exe（XAMPP） - macOS/Linux 常见路径：
/usr/bin/php（系统自带，不推荐用于开发）、/opt/homebrew/bin/php（Homebrew）、/Applications/MAMP/bin/php/php8.2.12/bin/php - 选完后务必检查右下角状态栏是否显示 PHP 版本号；若显示“Not configured”，说明路径无效或权限不足
服务器映射不配，Xdebug 断点永远不触发
即使 php -v 正常、phpinfo() 能访问，没配服务器映射，PhpStorm 就不知道浏览器请求的 http://localhost/index.php 对应你项目里的哪个文件，Xdebug 无法关联断点。
- 进
Settings → Languages & Frameworks → PHP → Servers，点 + 添加 -
Host填localhost，Port填实际 Web 服务端口（Apache 默认 80，Nginx 常为 8080，phpStudy 可在面板查看） - 必须勾选
Use path mappings，并确保Project root（如D:\phpstudy_pro\WWW\myapp）映射到Web root（如/myapp或/） - 映射错误的典型现象：断点灰掉、控制台提示
Cannot resolve path 'index.php' on server
php.ini 中 Xdebug 配置必须匹配 PhpStorm 监听端口
Xdebug 3 默认监听 9003，而 PhpStorm 默认监听 9000，不统一就收不到调试请求。
立即学习“PHP免费学习笔记（深入）”；
- 编辑你的
php.ini，确认包含且仅启用一组配置（删掉旧的xdebug.remote_*遗留项）：
zend_extension=xdebug xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003
- 重启 Web 服务（如 phpStudy 的 Apache/Nginx）或 PHP-FPM
- 在 PhpStorm 中点击
Run → Start Listening for PHP Debug Connections（小电话图标亮起） - 用浏览器插件（如 Xdebug Helper）或加
?XDEBUG_SESSION_START=PHPSTORM触发调试，看是否弹出 “Breakpoint reached” 提示
最容易被忽略的是服务器映射路径和 Xdebug 端口的一致性——它们不在同一个界面里设置，但必须协同生效。改完任一端，另一端不对应，调试就静默失败。
