PhpStorm本身不运行PHP，仅调用指定的php可执行文件；配置失败主因是GUI启动未继承shell环境变量，需手动配置which php或where php获取的绝对路径，并确保CLI php.ini启用Xdebug且端口为9003，同时正确设置服务器路径映射与Composer路径。
PhpStorm 本身不运行 PHP，它只调用你指定的 php 可执行文件；配置失败的绝大多数情况，不是 PhpStorm 有 bug，而是它根本没加载你预期的那个 PHP 实例——尤其当你在终端能跑 php -v，但在 PhpStorm 里报“Command not found”或断点不触发时，基本可以锁定是路径、环境变量或 php.ini 加载错位导致的。
为什么 PhpStorm 找不到 php 命令
GUI 启动的 PhpStorm（比如 macOS 从 Dock 点开、Windows 双击快捷方式）默认不继承 shell 的 PATH。即使你在终端里 which php 能拿到 /opt/homebrew/bin/php，PhpStorm 内置 Terminal 也可能显示 command not found。
- 别依赖“自动检测”或 PATH 猜测：Settings → PHP → Interpreter 页面里必须手动点击“…”浏览并选中绝对路径，例如
/opt/homebrew/bin/php或C:\php\php.exe - 确认选中后右下角显示类似
PHP 8.2.12 (cli)，否则说明路径不可执行、权限不足，或该二进制依赖缺失（如 Windows 缺msvcr120.dll） - macOS 用户若用 Homebrew 安装 PHP，
which php返回的是符号链接，PhpStorm 需要指向真实路径（可用ls -l $(which php)查看）
怎么确认 PhpStorm 实际加载的是哪个 php.ini
Web SAPI（Apache/Nginx）和 CLI 是两套独立配置。你在 /etc/php/8.2/apache2/php.ini 里加了 Xdebug，对 PhpStorm 完全无效——它只认 CLI 版本加载的配置。
- 打开 PhpStorm 内置 Terminal，运行
php --ini，重点看Loaded configuration file:后面的路径 - 如果显示
none，说明没加载任何配置；如果路径是/usr/local/etc/php/8.2/php.ini，那你改/etc/php/8.2/cli/php.ini就白忙活 - Homebrew 用户默认读
/opt/homebrew/etc/php/8.x/php.ini；源码编译用户得查configure时的--with-config-file-path参数
xdebug.mode=debug 不生效的常见原因
Xdebug 3 要求显式启用调试模式，且端口、主机、启动策略必须全部匹配，缺一不可。只写 zend_extension=xdebug 是不够的。
立即学习“PHP免费学习笔记（深入）”；
- 确保 CLI
php.ini中包含完整配置（注意路径是否对应）：zend_extension=xdebug xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003
- PhpStorm Settings → PHP → Debug 中的 Xdebug 端口必须与
xdebug.client_port一致（默认 9003，不是旧版的 9000） - 改完
php.ini后必须重启 PhpStorm（不是重载项目），再在 Terminal 里运行php -m | grep xdebug确认扩展已加载 - 浏览器需配合 Xdebug Helper 插件（Chrome/Firefox），并切换到 “Debug” 模式，否则请求不会带
XDEBUG_SESSION_START参数
服务器路径映射配错，调试永远连不上
断点打了、监听开了、Xdebug 日志也显示“connection established”，但 PhpStorm 就是不停——八成是 Servers 映射没对上。Xdebug 发起的调试连接被当成未知请求丢弃了。
- Settings → PHP → Servers，新建一个 Server，Host 填
localhost，Port 填你 Web 服务实际监听的端口（如 80、8080 或 8000） - 务必勾选
Use path mappings，然后把你的项目根目录（如/Users/name/project）映射到 Web 根路径（如/或/myapp） - 映射路径必须严格匹配：如果项目在
D:\phpstudy_pro\WWW\myproject，而 Web 服务访问的是http://localhost/myproject/，那映射目标就得是/myproject，不能是/ - 验证方法：在浏览器访问
http://localhost/test.php，同时看 PhpStorm 是否能跳转到该文件——跳转失败，说明映射错位
最易被忽略的一点：PHPStorm 的 CLI 解释器、Xdebug 加载的 php.ini、Web 服务器使用的 PHP SAPI，这三者可能指向完全不同的 PHP 安装。不要假设它们共享配置，每个环节都得单独验证路径和版本。
