PHPStorm中Composer配置必须填真实composer.phar路径，不可用软链接或bat；需Validate验证、手动Reload项目、取消vendor目录Excluded，三者缺一不可。
Path to composer.phar 必须填真实 .phar 文件路径，不是软链接或 wrapper
PHPStorm 不解析 shell 路径逻辑，填 /usr/local/bin/composer 或 composer.bat 会导致“Cannot find Composer executable”错误或静默失败。它要的是能直接执行的 PHAR 二进制入口。
验证方法：终端运行 composer --version --no-ansi，输出里明确写着加载的 .phar 路径（例如 /opt/homebrew/Cellar/composer/2.7.7/libexec/composer.phar）；macOS 用户别信 which composer，用 ls -l $(which composer) 追到底层；Windows 用户必须选 composer.phar，不是同目录下的 composer.bat。
填完后务必点 Validate 按钮——它会真实调用一次 composer --version。只有弹出版本号才算通过，红字报错是配置失败的铁证。
autoload 不生效？不是配置问题，是索引没触发
即使 composer.json 里写了正确的 "psr-4": {"App\": "src/"}，PHPStorm 也不会自动识别 AppFoo 类——它不监听 vendor/ 变化，也不主动解析 vendor/autoload.php。
立即学习“PHP免费学习笔记（深入）”；
必须手动触发索引更新才能启用补全、跳转和类型推导：
- 右键项目根目录 → Reload project from composer.json（该选项只在识别到
composer.json后出现） - 或按
Ctrl+Alt+Y（Win/Linux） /Cmd+Alt+Y（macOS）执行 Synchronize - 检查
Settings → PHP → Composer是否勾选了 Synchronize IDE settings with composer.json——这个开关控制是否自动响应composer.json变更并重载 autoload 映射
PHPStorm 内置 Composer 工具窗口执行失败的常见原因
点击 Composer → Install 或 Update 报 Could not write to /path/to/vendor 或 file_put_contents(.../composer.lock): failed to open stream，本质是权限或环境不一致：
- 确认当前用户对
vendor/、composer.lock、composer.json有完整读写权限（尤其 Docker/WSL 挂载目录时容易丢写权限） - 避免用
sudo phpstorm.sh启动；若必须，改用sudo -u $USER phpstorm.sh - GUI 启动的 PHPStorm 不加载 shell 配置（如
.zshrc中的export COMPOSER_HOME），可在Help → Edit Custom Properties中添加对应环境变量 - 终端工具窗口（Terminal）默认复用系统 Shell 环境，而内置 Composer 工具窗口使用独立 PHP 运行时，行为可能不一致
vendor 目录被排除？类补全直接失效
PHPStorm 有时会把 vendor/ 标记为 “Excluded”，导致所有第三方类无法被索引——右键 vendor 目录 → Mark Directory as → Not Excluded 是必要操作。
此外注意：
- 确保
Project SDK已指定有效 PHP 解释器（Settings → Languages & Frameworks → PHP） - 如果项目根目录下没有
composer.json，PHPStorm 不会激活 Composer 支持，右键菜单里的相关选项会灰掉 - 自定义脚本（如
"scripts": {"post-install-cmd": "MyClass::doSomething"}）无法通过 PHPStorm 内置界面触发，必须走 Terminal 手动执行composer run post-install-cmd
.phar 路径后没点 Validate、配完 composer.json 没手动 Reload、以及 vendor 目录被意外 Exclude。这三项不处理，其余设置全是空转。 
