phpstorm调试失败90%因php路径或php.ini配置错误；需在ide内置终端查which php和php --ini确认实际使用的php及cli配置文件，手动指定正确路径并启用xdebug 3的zend_extension、xdebug.mode=debug、xdebug.client_host等参数，wsl2用户须用原生路径或正确映射。
PhpStorm 本身不运行 PHP，它只调用你本地装好的 php 可执行文件——配置失败，90% 是因为路径没对上，或者根本没装 PHP。
怎么确认 PhpStorm 实际用的是哪个 php
别信终端里 php -v 能跑就万事大吉。GUI 启动的 PhpStorm（比如 macOS 从 Dock 点开、Windows 用快捷方式）压根不继承 shell 的 PATH，它可能根本找不到你装的 php。
- 在 PhpStorm 内置 Terminal 里直接运行
which php（macOS/Linux）或where php（Windows），拿到的是它实际能访问到的路径 - 如果返回空，说明它连命令都找不到；如果返回路径但版本不对，说明你装了多个 PHP，它选错了那个
- 打开
Settings → Languages & Frameworks → PHP → Interpreter，点齿轮 → Add → Local，必须手动浏览并选中上面那条路径里的php文件（不是文件夹，不是php.ini） - 选完后右下角要显示类似
PHP 8.2.12 (cli)，否则就是路径错、权限不足，或该二进制缺依赖（比如 Windows 缺msvcr120.dll）
为什么 test.php 能 Run 却不能 Debug
CLI 解释器和 Xdebug 是两套逻辑：配好 php 路径 ≠ Xdebug 就自动生效。关键在 CLI 模式下加载的 php.ini 是否启用了 Xdebug。
- 在 PhpStorm Terminal 里运行
php --ini，看Loaded Configuration File行——这才是它调试时读的配置，不是浏览器里phpinfo()显示的那个 - 常见 CLI 配置路径：
/etc/php/8.2/cli/php.ini（Ubuntu）、/opt/homebrew/etc/php/8.2/php.ini（Mac Homebrew）、C:\php\php.ini（Windows 手动安装） - 编辑这个
php.ini，加三行（Xdebug 3）：zend_extension=xdebug、xdebug.mode=debug、xdebug.client_host=127.0.0.1，端口默认是9003，别写成旧版9000 - 改完重启 PhpStorm，再在 Terminal 里跑
php -m | grep xdebug，有输出才代表扩展真加载了
WSL2 用户特别注意路径映射
如果你在 Windows 上用 WSL2 跑 PHP，别把项目放 /mnt/c/xxx 下再让 PhpStorm 直接读 Windows 路径——inode 不一致、文件保存失败、断点不触发全是常态。
- 推荐做法：项目放在 WSL2 原生路径，比如
~/projects/myapp，然后在 PhpStorm 里用File → Open，地址栏切到WSL: Ubuntu视图去打开 - 如果非要用 Windows 路径，必须走
Settings → PHP → CLI Interpreter → Add → WSL，让 PhpStorm 自动建立C:\xxx↔/mnt/c/xxx映射，否则断点位置永远对不上 - Composer 也得同步指向 WSL2 里的
which composer，而不是 Windows 下的composer.bat，否则composer install在 IDE 里会静默失败
最常被跳过的一步：确认 php --ini 输出的 Loaded Configuration File 和你编辑的 php.ini 是同一个文件。很多人改了 Apache 的配置，却忘了 CLI 根本不认它。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
