PhpStorm找不到php命令的根本原因是GUI启动不继承shell环境变量，需先用which php或where php获取绝对路径，再在Settings→PHP→Interpreter中手动指定；macOS须用open -a PhpStorm启动，Windows需选php.exe而非php-cgi.exe。
PhpStorm找不到php命令，根本不是它的问题
它压根不读你终端里配置好的PATH——macOS用Dock启动、Windows用快捷方式启动时，GUI进程根本不加载shell环境变量。别试“自动检测”，也别信“系统已装好就一定能用”。
先在终端执行which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如：/opt/homebrew/bin/php 或 C:\php\php.exe。
- Mac用户：Homebrew安装的PHP路径常为
/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel），别抄/usr/bin/php——那是系统弃用版本 - Windows用户：若用XAMPP/WAMP，务必选
php.exe，不是php-cgi.exe；后者不支持CLI交互，断点会静默失效 - 路径里不能含空格或中文，否则PhpStorm会静默失败（比如
C:\Program Files\php\php.exe直接无效） - Linux/macOS下确认文件有执行权限：
chmod +x /path/to/php
Settings里填对路径，但右下角没显示PHP版本？
说明配置未生效，常见原因不是路径错，而是启动方式不对。
- Mac用户必须用终端启动：
open -a PhpStorm（确保该终端已加载~/.zshrc或~/.bash_profile）；用Dock图标点开，which php结果再准也没用 - Windows用户检查是否双击快捷方式启动——改用开始菜单中“PhpStorm (64-bit)”或直接运行
phpstorm64.exe，避免旧版兼容模式干扰 - 选完路径后，右下角应立刻显示类似
PHP 8.2.12 (cli)；若仍为空，打开PhpStorm内置Terminal，手动执行/your/path/to/php -v验证路径是否真能跑
为什么test.php能Run却不能Debug？
因为CLI解释器和Xdebug调试器是两套逻辑。配对PHP路径≠Xdebug就绪。
立即学习“PHP免费学习笔记（深入）”；
- 在PhpStorm内置Terminal里运行
php --ini，确认它加载的是CLI版php.ini（常见路径：/etc/php/8.2/cli/php.ini或C:\php\php.ini），不是Apache/Nginx用的那个 - Xdebug 3最小必要配置只有三行，写进CLI对应的
php.ini：zend_extension=xdebug xdebug.mode=debug xdebug.client_host=127.0.0.1
端口默认9003，别写成旧版9000 - 检查
extension_dir指向目录下是否存在xdebug.so（Linux/macOS）或php_xdebug.dll（Windows）
Composer报command not found，跟PHP解释器设置无关
PhpStorm的PHP解释器设置和Composer路径完全独立，GUI启动时不会复用shell的PATH。
- 进
Settings → Languages & Frameworks → PHP → Composer，勾选Use composer executable - 填入
which composer的真实路径，例如：/opt/homebrew/bin/composer（Mac Homebrew）或C:\Users\YourName\scoop\shims\composer.bat（Windows Scoop） - 如果项目用
composer.phar，直接指向该文件即可，不用全局安装
路径映射不对是最隐蔽的调试失败原因——Xdebug发来的请求里带的是服务器上的绝对路径（如/var/www/project/index.php），而PhpStorm本地只认/Users/you/project/index.php，差一毫秒都不停。这个映射不在PHP解释器设置里调，而在Run → Edit Configurations → Server Configuration里配。
