PhpStorm GUI启动时不读取shell环境变量，必须手动指定PHP绝对路径并配置CLI版php.ini中的Xdebug；服务器路径映射必须与浏览器访问URL严格一致，且Composer需单独配置路径。
PhpStorm找不到php命令，根本不是PATH没配好
它压根不读你终端里~/.zshrc或PATH里的路径——GUI启动时（Dock点击、Windows快捷方式）根本不加载shell环境变量。
别试Settings里那个“Auto-detect”，也别指望它自动继承终端配置。必须手动指定绝对路径：
- 先在终端运行
which php（macOS/Linux）或where php（Windows），拿到真实路径，比如/opt/homebrew/bin/php或C:\php\php.exe - macOS用户务必用
open -a PhpStorm从终端启动，否则~/.zshrc白配 - Windows别选
php-cgi.exe，只认php.exe；路径含空格或中文会静默失败 - 选完后看右下角是否显示
PHP 8.2.12 (cli)，没显示就检查文件权限（Linux/macOS需chmod +x）或缺失DLL（Windows常见msvcr120.dll）
phpinfo()和PhpStorm里php --ini显示的配置不一致
因为Web服务器（Apache/Nginx）用的是apache2/php.ini，而PhpStorm调用的是CLI版本，加载的是cli/php.ini——改错地方，Xdebug就永远不生效。
验证当前CLI实际加载哪份配置：
立即学习“PHP免费学习笔记（深入）”；
- 在PhpStorm内置Terminal里执行
php --ini，看清Loaded Configuration File路径 - 常见CLI路径：
/etc/php/8.2/cli/php.ini（Ubuntu）、C:\php\php.ini（Windows）、/opt/homebrew/etc/php/8.2/php.ini（macOS Homebrew） - Xdebug 3最小必要配置只有三行，必须写在这份
cli/php.ini里：zend_extension=xdebugxdebug.mode=debugxdebug.client_host=127.0.0.1 - 端口默认是
9003，不是旧版9000；改完重启PhpStorm，再用php -m | grep xdebug确认加载成功
断点打了，“Start Listening”也点了，就是不中断
90%是服务器路径映射没对上——Xdebug发来的调试请求被PhpStorm当成未知连接直接丢弃了，根本不会进断点。
关键不是“有没有监听”，而是“请求能不能被正确路由到你的项目文件”：
- 进Settings → Languages & Frameworks → PHP → Servers，添加或检查现有服务器配置
- Host填
localhost，Port填Web服务实际端口（如Apache是80，Nginx是8080） - 必须勾选
Use path mappings，把本地项目根目录（如/Users/name/project）映射到Web路径（如/或/myapp） - 映射关系要和浏览器访问URL完全一致：如果访问
http://localhost/test.php，那Web路径就得是/；如果访问http://localhost/myapp/test.php，就得映射到/myapp - phpStudy/XAMPP用户注意：项目目录必须设为
www或htdocs子目录，且映射路径与URL路径严格对应
Composer报command not found，和PHP解释器配置无关
PhpStorm的PHP解释器设置和Composer路径是两套独立逻辑——GUI进程不复用shell的PATH，所以即使终端能跑composer，IDE里照样找不到。
必须单独配置Composer可执行文件路径：
- 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，直接指向该文件即可，无需全局安装 - 路径里有空格或中文？PhpStorm会静默失败，不报错也不工作
php.ini的区分，以及GUI进程与shell环境变量的隔离机制。 
