PhpStorm本身不运行PHP，仅调用本地CLI解释器；配置失败主因是路径错误、CLI php.ini未启用Xdebug（端口9003）、服务器路径映射不匹配或GUI启动未继承shell环境变量，需手动指定which php路径并验证php --ini加载的配置。
PhpStorm 本身不运行 PHP，它只调用你本地已安装的 PHP 解释器；配置失败，90% 是因为路径没对上、CLI 的 php.ini 没启用 Xdebug，或服务器路径映射错位——不是 PhpStorm 不行，是它根本没连上你系统里那个真实的 PHP。
怎么确认 PhpStorm 能真正调用到你的 PHP
别信终端里 php -v 能跑就万事大吉。GUI 启动的 PhpStorm（比如 macOS 从 Dock 点开、Windows 双击快捷方式）默认不加载 shell 的 PATH，which php 在终端有效，但在 PhpStorm 里可能完全找不到。
- 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/opt/homebrew/bin/php或C:\php\php.exe - 打开 PhpStorm → Settings / Preferences → Languages & Frameworks → PHP → Interpreter → 点击齿轮图标 → Add → Local → 用「…」手动选中上面那个路径，不是“自动检测”
- 选完后右下角必须显示类似
PHP 8.2.12 (cli)，否则就是路径错、权限不足（Linux/macOS 下检查chmod +x /path/to/php），或该二进制缺依赖（Windows 常见缺msvcr120.dll）
为什么 test.php 能 Run 却不能 Debug
Run 和 Debug 是两套独立机制：Run 只需要解释器路径正确；Debug 还强依赖 Xdebug 是否在 CLI 的 php.ini 里启用，且端口、host、映射全对得上。
- 在 PhpStorm 内置 Terminal 里运行
php --ini，看它实际加载哪个php.ini（常见路径：/etc/php/8.2/cli/php.ini或C:\php\php.ini），不是 Apache/Nginx 那个 - 编辑对应 CLI 的
php.ini，确保有这三行（Xdebug 3 最小必要配置）：zend_extension=xdebugxdebug.mode=debugxdebug.client_host=127.0.0.1
端口默认9003，别写成旧版9000 - 改完重启 PhpStorm，再在 Terminal 里跑
php -m | grep xdebug，输出非空才表示扩展已加载
服务器 URL 映射配错，断点永远不触发
点了 Start Listening for PHP Debug Connections、打了断点、浏览器也装了 Xdebug Helper 插件，但就是不中断——大概率是 PhpStorm 根本没把 Xdebug 发来的调试连接匹配到你的项目路径。
立即学习“PHP免费学习笔记（深入）”；
- 进入 Settings → Languages & Frameworks → PHP → Servers → 添加服务器，Host 填
localhost，Port 填你 Web 服务实际端口（如 8080） - 务必勾选
Use path mappings，然后把「项目根目录」（如/Users/me/project）映射到「Web 路径」（如/或/myapp/），这个映射必须和你浏览器访问的 URL 路径一致 - 如果用 phpStudy/XAMPP，项目根目录通常是
D:\phpstudy_pro\WWW或/Applications/XAMPP/xamppfiles/htdocs，映射目标要写成/，不是/htdocs/
Composer 报 command not found 怎么办
PHPStorm 默认不复用 shell 的 PATH，尤其 GUI 启动时，它不会自动从环境变量里找 composer。
- 进 Settings → Languages & Frameworks → PHP → Composer，勾选
Use composer executable - 填入
which composer的结果，例如/opt/homebrew/bin/composer；Windows 上若用 Scoop，路径可能是C:\Users\YourName\scoop\shims\composer.bat - 避免路径含空格（如
C:\Program Files\...），PHPStorm 会静默失败；若项目里直接用了composer.phar，就指向那个文件
最常被忽略的其实是 CLI 和 Web SAPI 的 php.ini 分离——你在浏览器里看到 phpinfo() 有 Xdebug，不代表 PhpStorm 调试时用的也是同一个配置。动手前先跑 php --ini，比反复重启服务有用得多。
