PhpStorm找不到php命令的根本原因是GUI启动不继承shell环境变量，需用which php或where php获取绝对路径后在Settings→PHP→Interpreter中手动指定；macOS须用open -a PhpStorm启动，Windows需选php.exe而非php-cgi.exe，并确保CLI php.ini启用Xdebug且端口为9003，同时正确配置服务器路径映射。
PhpStorm找不到php命令，根本原因不是IDE坏了
它压根没读你的PATH环境变量——尤其是 macOS 从 Dock 启动、Windows 用快捷方式启动时，GUI 进程不加载 shell 的配置。终端里能跑 php -v，PhpStorm 里报“Command 'php' not found”，就是典型症状。
- 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，比如/usr/local/bin/php或C:\php\php.exe - 进 Settings → Languages & Frameworks → PHP → Interpreter → 点齿轮 → Add Interpreter → Local → 浏览并选中这个真实路径，别信“自动检测”
- 选完后右下角必须显示类似
PHP 8.2.12 (cli)，否则路径错、权限不足，或该二进制缺依赖（如 Windows 缺msvcr120.dll）
phpinfo() 和 PhpStorm 调试看到的配置不一致
因为 Web SAPI（Apache/Nginx 加载的 PHP）和 CLI（命令行）默认用两套 php.ini 文件，而 PhpStorm 默认调用的是 CLI 版本。你在 /etc/php/8.2/apache2/php.ini 里加了 Xdebug，对 PhpStorm 完全无效。
- 在 PhpStorm 内置 Terminal 里运行
php --ini，确认它实际加载的是哪个php.ini（常见路径：/etc/php/8.2/cli/php.ini或C:\php\php.ini） - 编辑对应 CLI 的
php.ini，加入 Xdebug 3 配置（注意版本匹配）：zend_extension=xdebugxdebug.mode=debugxdebug.start_with_request=yesxdebug.client_host=127.0.0.1xdebug.client_port=9003 - 改完重启 PhpStorm，再在 Terminal 里运行
php -m | grep xdebug确认扩展已加载
断点打了，“Start Listening for PHP Debug Connections”也点了，但就是不中断
Xdebug 发起的调试连接被 PhpStorm 当成未知请求丢弃了——99% 是服务器路径映射没对上。
- 进 Settings → Languages & Frameworks → PHP → Servers → 点 “+” 添加服务器
- Host 填
localhost，端口填你 Web 服务实际监听的端口（如 Apache 默认 80，Nginx 默认 80 或 8080） - 务必勾选 “Use path mappings”，把项目根目录（如
D:\phpstudy_pro\WWW）映射到 Web 路径/ - 如果项目放在子目录（如
/myapp/），映射路径就得写成/myapp/，否则 Xdebug 回传的文件路径和 PhpStorm 本地路径无法匹配
用 phpStudy 快速搭环境时最容易漏掉的三件事
phpStudy 确实省事，但路径、服务状态、CLI 配置三处一错，整个调试链就断了。
立即学习“PHP免费学习笔记（深入）”；
- PhpStorm 项目根目录必须设为 phpStudy 的
WWW目录（如D:\phpstudy_pro\WWW），不能只是“打开子文件夹” - phpStudy 必须已启动 Apache/Nginx 且状态栏显示绿色，否则浏览器访问
http://localhost都失败，Xdebug 更无从触发 - phpStudy 自带的 PHP 可执行文件路径通常是
D:\phpstudy_pro\Extensions\php\php8.2.12\php.exe（版本号随安装变），得用这个路径配解释器，而不是系统 PATH 里的其他 PHP
xdebug.client_port 默认是 9003，但很多老教程还写 9000；PHP 8.5.5 已支持，但若用旧版 Xdebug 2 就会直接加载失败——这种细节不查日志根本看不出问题。 
