phpstorm找不到php命令是因为gui启动不继承shell环境变量；必须用终端执行which php或where php获取绝对路径，手动配置interpreter，并通过open -a phpstorm启动以加载path，同时区分cli与web版php.ini，确保xdebug配置在cli对应文件中。
PhpStorm找不到php命令，根本不是路径没装好
它压根不读你终端里配置好的PATH——macOS用Dock启动、Windows用快捷方式启动时，GUI进程根本不加载shell环境变量。别试“自动检测”，也别信“系统已装好就一定能用”。
- 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/opt/homebrew/bin/php或C:\php\php.exe - 打开
Settings → Languages & Frameworks → PHP → Interpreter，点齿轮→Add → Local，手动选中上面那条路径 - 选完立刻看右下角是否显示类似
PHP 8.2.12 (cli)；没显示，要么路径错，要么文件没执行权限（Linux/macOS需chmod +x） - Mac用户尤其注意：必须用
open -a PhpStorm从终端启动，才能继承~/.zshrc里的环境变量
phpinfo()和PhpStorm里php --ini显示的配置不一致
因为Web SAPI（Apache/Nginx）和CLI用的是两套php.ini，而PhpStorm默认调用CLI版本。你在/etc/php/8.2/apache2/php.ini里加了Xdebug，对它完全无效。
- 在PhpStorm内置Terminal里运行
php --ini，确认它实际加载的是哪个php.ini（常见路径：/etc/php/8.2/cli/php.ini或C:\php\php.ini） - Xdebug 3必须装在CLI对应的
php.ini里，不是Web的那个 - 检查
extension_dir指向的目录下是否有xdebug.so（Linux/macOS）或php_xdebug.dll（Windows） - Xdebug 3最小必要配置只有三行：
zend_extension=xdebug、xdebug.mode=debug、xdebug.client_host=127.0.0.1，端口默认9003，别写成旧版9000
配置了php解释器，但composer仍报command not found
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） - 路径里不能有空格或中文，否则PhpStorm会静默失败
- 如果项目用
composer.phar，直接指向那个文件即可，不用全局安装
断点打了，“Start Listening for PHP Debug Connections”也点了，就是不中断
大概率是服务器路径映射没对上，Xdebug发来的调试连接被PhpStorm当成未知请求丢弃了。
- 进
Settings → Languages & Frameworks → PHP → Servers，确保已添加服务器且勾选Use path mappings - 本地路径（如
D:\phpstudy_pro\WWW\myproject）必须精确映射到Web路径（如/myproject），不能多斜杠、不能少层级 - 浏览器访问URL必须匹配该映射（例如
http://localhost/myproject/index.php），否则Xdebug传过来的SCRIPT_FILENAME和PhpStorm里存的路径对不上 - 用
phpinfo()确认xdebug.mode确实是debug，且xdebug.client_port没被防火墙或其它服务占用
realpath()和PhpStorm看到的路径稍有偏差，调试就会彻底静默失效。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
