根本原因是PhpStorm GUI启动不继承shell环境变量，需手动指定which php或where php获取的绝对路径，并确保CLI php.ini启用Xdebug、端口为9003，且服务器路径映射精确匹配。
PhpStorm 找不到 php.exe 或 php 命令
根本原因不是 PhpStorm 故障，而是它启动时压根没加载你终端里的 PATH —— macOS 从 Dock 启动、Windows 用快捷方式双击，GUI 进程默认不读 shell 配置。所以 which php（macOS/Linux）或 where php（Windows）在终端能跑，PhpStorm 却报 “Interpreter not found”。
- 必须手动定位：在终端执行
which php，拿到绝对路径，比如/opt/homebrew/bin/php或C:\php\php.exe - 别点 “Auto-detect”：Settings → PHP → Interpreter → ⚙️ → Add → Local → 浏览，精准选中那个
php文件 - 选完立刻验证：右下角应显示类似
PHP 8.2.12 (cli)；若无，检查文件权限（Linux/macOS）、msvcr120.dll是否缺失（Windows）、或该二进制是否依赖其他动态库
CLI 和 Web 的 php.ini 不一致导致 Xdebug 失效
你在 /etc/php/8.2/apache2/php.ini 里加了 Xdebug，但 PhpStorm 调用的是 CLI 模式，实际加载的是 /etc/php/8.2/cli/php.ini（macOS/Linux）或 C:\php\php.ini（Windows）。断点不触发，八成卡在这儿。
- 先确认 PhpStorm 用的是哪个配置：
php --ini（在 PhpStorm 内置 Terminal 中运行） - 只改 CLI 对应的
php.ini，Xdebug 3 必须写这 4 行（缺一不可）：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，再跑
php -m | grep xdebug确认扩展已载入；php -v末尾应带with Xdebug v3.x
断点打了，监听也开了，但就是不中断
“Start Listening for PHP Debug Connections” 按了，浏览器装了 Xdebug Helper，Xdebug 日志也显示连接尝试，但 PhpStorm 就是不跳断点 —— 八成是服务器路径映射没对上，Xdebug 发来的调试请求被当成陌生来源丢弃了。
- 进 Settings → PHP → Servers，新建一个 Server，Host 填
localhost，Port 填你 Web 服务实际端口（如 80、8080、或 phpStudy 的 80） - 务必勾选
Use path mappings，然后把你的项目根目录（如D:\phpstudy_pro\WWW）映射到/（Web 根路径） - 映射必须精确：如果项目在
/var/www/myapp，而 Apache DocumentRoot 是/var/www，那就要映射/var/www/myapp→/myapp，不能全映射到/
phpinfo() 显示正常，但 PhpStorm 运行单个 PHP 文件报错
浏览器访问 http://localhost/test.php 能看到 phpinfo()，说明 Web SAPI 没问题；但右键 Run test.php 却报错，这是典型 CLI 环境和 Web 环境脱节。
立即学习“PHP免费学习笔记（深入）”；
- PhpStorm 默认用 CLI 解释器运行脚本，它不走 Apache/Nginx，也不读 Web 版 php.ini
- 确保 CLI
php.ini里没禁用关键扩展（如extension=mysqli），否则php -r "new mysqli();"都会失败 - 如果项目依赖
$_SERVER['DOCUMENT_ROOT']等 Web 变量，直接 Run 会出错——这类脚本必须通过浏览器访问，不能靠右键 Run
