PhpStorm找不到php命令的根本原因是GUI启动不继承shell环境变量，需先用which php或where php获取绝对路径，再在Settings→PHP→Interpreter中手动指定；macOS须用open -a PhpStorm启动，Windows需选php.exe而非php-cgi.exe。
PhpStorm 找不到 php 命令，不是它坏了，而是 GUI 启动时根本没读你终端里配好的 PATH —— macOS 用 Dock 点开、Windows 用快捷方式双击，shell 环境变量全丢了。必须手动指定绝对路径，否则 php -v 报错、phpinfo() 不生效、断点永远不触发。
PhpStorm 找不到 php 命令：先定位真实路径
别试“自动检测”，也别在设置里瞎点浏览。打开终端（macOS/Linux）或命令提示符（Windows），直接运行：
-
which php（macOS/Linux）→ 返回类似/opt/homebrew/bin/php或/usr/bin/php -
where php（Windows）→ 返回类似C:\php\php.exe或C:\xampp\php\php.exe
拿到这个路径后，进 PhpStorm → Settings → Languages & Frameworks → PHP → Interpreter → 齿轮图标 → Add → Local → 手动选中刚才那个文件。选完立刻看右下角是否显示 PHP 8.2.12 (cli) 这类字样；没显示，要么路径错，要么该文件没执行权限（Linux/macOS 需 chmod +x），要么 Windows 缺依赖 DLL（比如 msvcr120.dll）。
CLI 和 Web 的 php.ini 是两套：Xdebug 必须装在 CLI 版本里
你在 /etc/php/8.2/apache2/php.ini 里加了 xdebug，对 PhpStorm 完全无效 —— 它调用的是 CLI SAPI，加载的是 /etc/php/8.2/cli/php.ini（macOS/Linux）或 C:\php\php.ini（Windows）。验证方法：在 PhpStorm 内置 Terminal 里运行 php --ini，看 “Loaded Configuration File” 指向哪。
立即学习“PHP免费学习笔记（深入）”；
- 编辑那个 CLI 对应的
php.ini - 确认
extension_dir指向的目录下有xdebug.so（macOS/Linux）或php_xdebug.dll（Windows） - 只加这三行就足够启动调试：
zend_extension=xdebug、xdebug.mode=debug、xdebug.client_host=127.0.0.1（端口默认9003，别写旧版9000） - 改完重启 PhpStorm，再在 Terminal 里跑
php -m | grep xdebug确认已加载
Composer 报 command not found：路径必须单独配
PhpStorm 的 PHP 解释器设置和 Composer 路径是两套独立逻辑。GUI 启动不继承 shell 的 PATH，所以即使终端能跑 composer，PhpStorm 里照样报错。
- Settings → Languages & Frameworks → PHP → Composer
- 勾选 Use composer executable
- 填入
which composer的真实路径，例如：/opt/homebrew/bin/composer（macOS Homebrew）或C:\Users\YourName\scoop\shims\composer.bat（Windows Scoop） - 路径里不能含空格或中文，否则静默失败；若项目用
composer.phar，直接指向那个文件即可
断点打了，“Start Listening” 也点了，就是不中断：服务器路径映射错了
这是最常被忽略的环节。Xdebug 发来的调试请求包含当前脚本的绝对路径（比如 /Users/name/project/index.php），PhpStorm 只有在 Servers 设置里把本地路径和 URL 路径严格映射上，才能匹配并接管调试流程。映射不对，请求直接被丢弃。
- Settings → Languages & Frameworks → PHP → Servers
- 点 + 添加服务器，Host 填
localhost，Port 填实际端口（如 8080） - 勾选 Use path mappings
- 左侧填项目根目录（如
/Users/name/project），右侧填 Web 访问路径（如/或/myapp），必须跟浏览器里访问的 URL 一致 - 如果用 phpStudy/XAMPP，常见映射是
D:\phpstudy_pro\WWW→/；用内置 PHP Server 则通常映射为/
路径映射是调试链里最脆弱的一环，稍有偏差就静默失败，且没有任何错误提示 —— 它不会报错，只是跳过断点。
