PhpStorm 找不到 php 命令的根本原因是 GUI 进程未加载 shell 环境变量，需手动配置绝对路径；CLI 与 Web 的 php.ini 分离，Xdebug 必须配在 CLI 对应配置中；服务器路径映射必须严格匹配 Web 访问路径，否则调试连接被丢弃。
PhpStorm 找不到 php 命令，根本原因是 GUI 进程没加载 shell 环境变量
你终端里能跑 php -v，但 PhpStorm 里点“Test Interpreter”就报错“Command not found”，这不是 PhpStorm 故意为难你——而是 macOS 用 Dock 启动、Windows 用快捷方式启动时，GUI 应用压根不读 ~/.zshrc 或 PATH 环境变量。
必须手动提供绝对路径：
- macOS/Linux：在终端执行
which php，拿到类似/opt/homebrew/bin/php或/usr/local/bin/php的结果 - Windows：运行
where php，常见路径是C:\php\php.exe或C:\phpstudy_pro\Extensions\php\php8.2.12\php.exe - 进 PhpStorm →
Settings → Languages & Frameworks → PHP → Interpreter→ 点齿轮 →Add Interpreter → On Local→ 浏览并选中那个真实路径 - 选完后右下角必须显示类似
PHP 8.2.12 (cli)，否则就是路径错、权限不足，或缺依赖（比如 Windows 缺msvcr120.dll）
CLI 和 Web 的 php.ini 是两套，Xdebug 配错位置就等于没配
你在 /etc/php/8.2/apache2/php.ini 里加了 Xdebug，但 PhpStorm 调用的是 CLI 版本，所以断点永远不会触发。关键动作是确认它实际加载哪个配置文件：
在 PhpStorm 内置 Terminal 里运行：php --ini，看输出的 “Loaded Configuration File” 路径，常见有：
立即学习“PHP免费学习笔记（深入）”；
- macOS Homebrew：
/opt/homebrew/etc/php/8.2/php.ini - Linux apt：
/etc/php/8.2/cli/php.ini - Windows phpStudy：
C:\phpstudy_pro\Extensions\php\php8.2.12\php.ini
编辑那个 CLI 对应的 php.ini，追加（不是替换）以下内容（Xdebug 3+）：
zend_extension=xdebug xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003
改完保存，重启 PhpStorm，再在 Terminal 里跑 php -m | grep xdebug，有输出才说明扩展已加载。
服务器路径映射（Path Mapping）配错，Xdebug 连接会被直接丢弃
点了 Start Listening for PHP Debug Connections，浏览器也装了 Xdebug Helper，断点打了，但就是不中断——90% 是因为服务器映射没对上。Xdebug 发起的调试请求带的是 Web 路径（如 /index.php），而 PhpStorm 只认你本地项目路径（如 /Users/me/project），两者不匹配，连接就被静默丢弃。
进 Settings → Languages & Frameworks → PHP → Servers，新建一个：
- Host 填
localhost，Port 填你 Web 服务实际端口（Apache 默认 80，Nginx 常用 8080，phpStudy 多为 80） - 务必勾选
Use path mappings - 左边填你的项目根目录（如
/Users/me/project或D:\phpstudy_pro\WWW\myapp） - 右边填 Web 根路径（通常是
/；如果项目部署在子目录，比如http://localhost/myapp/，这里就得填/myapp/）
这个映射必须和浏览器访问时的真实 URL 路径严格一致，差一个斜杠或大小写都失败。
php -v 和 phpinfo() 显示版本不同，说明 CLI 和 Web SAPI 加载了不同 PHP 二进制
终端跑 php -v 是 8.2，但浏览器打开 phpinfo() 显示 8.1，说明你系统 PATH 里的 PHP 和 Web 服务器加载的 PHP 不是同一个。这本身不致命，但会误导你：你改了 CLI 的 php.ini，却以为 Web 也生效了。
查 Web 加载的是哪个 PHP：
- Apache：看
httpd.conf里LoadModule php_module指向的.so文件路径，再反推对应 PHP 安装目录 - Nginx + PHP-FPM：查
php-fpm.conf或www.conf里的php_admin_value[extension_dir]或直接运行ps aux | grep php-fpm看启动命令 - phpStudy：直接看控制面板里启用的 PHP 版本，对应扩展目录就在
Extensions\php\php8.x.x\下
真正麻烦的是混合环境：比如用 Homebrew 装 PHP（CLI），又用 phpStudy 启 Web 服务（SAPI）。这时你要分别维护两套 php.ini，Xdebug 也得按需启用在各自配置里——别指望一套配置通吃。
