直接用phpStudy+PhpStorm是最快路径，5分钟内能跑起phpinfo()，前提是phpStudy已启动且端口未被占用；需确认Apache/Nginx和PHP图标为绿色、localhost可访问、PhpStorm中PHP解释器路径指向phpStudy的php.exe、服务器映射路径准确、Xdebug配置一致并监听成功。
直接用 phpStudy + PhpStorm 是最快路径，5 分钟内能跑起 phpinfo()，前提是 phpStudy 已启动且端口没被占。
确认 phpStudy 服务已就绪
别跳过这步——很多“配置失败”其实卡在这儿。打开 phpStudy 控制面板，检查 Apache/Nginx 和 PHP 图标是绿色运行状态；浏览器访问 http://localhost 能看到欢迎页；用命令行执行 php -v 可能报错（因为 phpStudy 默认不加环境变量），但只要面板里 PHP 版本显示正常，就说明解释器可用。
- 默认 Web 根目录是
D:\phpstudy_pro\WWW（Windows）或/Applications/phpstudy_pro/WWW（macOS），路径必须和后面 PhpStorm 的项目根目录完全一致 - 如果改过端口（比如 Apache 改成 8080），后面 PhpStorm 的服务器配置 Host 就得填
localhost:8080，不是只写localhost - phpStudy v8 开始默认启用 Xdebug，但只在 PHP 版本页显示“已加载”，实际调试仍需 PhpStorm 主动监听
PhpStorm 中指定 php.exe 路径
关键不是“装了 PHP”，而是让 PhpStorm 知道用哪个 php.exe。路径藏在 phpStudy 的 Extensions 目录下，不是主程序目录。
- Windows 典型路径：
D:\phpstudy_pro\Extensions\php\php7.4.33nts\php.exe（注意nts表示非线程安全版，phpStudy 默认用这个） - macOS 路径类似：
/Applications/phpstudy_pro/Extensions/php/php8.1.22nts/bin/php - 选中后 PhpStorm 会自动读取
php.ini位置，但不会自动 reload —— 如果你刚改过php.ini（比如开 Xdebug），得手动点右上角的刷新按钮 - 别选错文件：
php-cgi.exe或php-win.exe不能用于 CLI 和调试，只认php.exe
配置 Servers 映射确保 URL 可访问
没有这步，右键“Open in Browser”会打不开，Xdebug 断点也触发不了——因为 PhpStorm 不知道 test.php 对应浏览器里的哪个 URL。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Languages & Frameworks → PHP → Servers，点 + 新建 - Host 填
localhost（或带端口），Port 填 phpStudy 实际监听的端口（Apache 默认 80，Nginx 默认 80） - 必须勾选
Use path mappings，然后把项目根目录（如D:\phpstudy_pro\WWW）映射到/（斜杠，不是空或点） - 如果项目在子目录（比如
D:\phpstudy_pro\WWW\myapp），映射关系就得是本地路径 →/myapp，否则浏览器访问http://localhost/myapp/test.php时 PhpStorm 找不到对应文件
验证调试是否真通
光看到 phpinfo() 输出不等于 Xdebug 就好了。断点必须在浏览器请求中触发，而不是靠 PhpStorm 的 Run 按钮。
- 在
php.ini里确认有这几行（phpStudy v8 默认已配好）：zend_extension=xdebug<br>xdebug.mode=debug<br>xdebug.start_with_request=yes<br>xdebug.client_host=127.0.0.1<br>xdebug.client_port=9003
- PhpStorm 里点右上角电话图标，确保显示 “Listening for Xdebug connections”
- 浏览器装 Xdebug Helper 插件，点灯泡图标设为 Debug，再刷新页面——这时 PhpStorm 才会弹出“Accept connection”对话框
- 如果断点灰掉、没反应，先检查 phpStudy 面板里 Xdebug 是否显示“已启用”，再看 PhpStorm 的 Event Log 里有没有 “Xdebug connection rejected” 类错误
最常被忽略的是路径映射和端口一致性：phpStudy 的 Apache 端口、Servers 配置里的 Port、浏览器访问的 URL 三者必须对齐；映射路径少一个斜杠或多个子目录，调试就静默失败。这些地方不报红错，但功能就是不工作。
