composer路径需填真实.phar文件，验证通过且重载项目、取消vendor排除、修复终端权限才能启用类补全与依赖管理。
Composer executable 路径填错，PhpStorm 就当它不存在
PhpStorm 不会自动继承系统 PATH，也不会顺着软链接去找真正的 composer.phar。你填 /usr/local/bin/composer 看似合理，但它很可能只是个 shell 脚本或软链接——PhpStorm 一执行就报 Cannot find Composer executable 或静默失败。
- 先在终端运行
which composer，再用ls -l查它到底指向哪，例如：ls -l /usr/local/bin/composer可能显示 →/opt/homebrew/Cellar/composer/2.5.8/bin/composer，而那个路径又是个 wrapper；真正要填的是/opt/homebrew/Cellar/composer/2.5.8/libexec/composer.phar - Windows 用户别选
composer.bat，必须选composer.phar（通常在C:\ProgramData\ComposerSetup\bin\composer.phar） - 填完后务必点
Validate按钮——它真会跑一次composer --version。只有弹出版本号才算通过，否则下方红字错误不是警告，是配置失败的铁证
composer.json 识别了，但类不补全、Ctrl+点击不跳转
路径对 ≠ 功能生效。PhpStorm 解析完 composer.json 后，默认不会主动加载 vendor/autoload.php 或扫描 PSR-4 映射，所以你写 new Monolog\Logger，IDE 依然没提示、跳不了。
- 右键项目根目录 →
Reload project from composer.json（注意不是 “Reload from disk”）——这是最直接有效的触发方式 - 确保
Settings → PHP → Composer中勾选了Synchronize IDE settings with composer.json，否则改了 autoload 规则 IDE 也无感 - 如果 vendor 目录被误标为
Excluded（右键 vendor →Mark Directory as → Excluded），手动取消：右键 vendor →Mark Directory as → Not Excluded - 极端情况可补一刀：
composer dump-autoload -o生成优化映射，再重载项目
PhpStorm 内置 Terminal 执行 composer install 报权限错误
常见报错：Could not write to /path/to/vendor 或 file_put_contents(/path/to/composer.lock): failed to open stream。这不是 Composer 问题，是 PhpStorm 启动时的用户环境和终端不一致导致的。
- 别用
sudo phpstorm.sh启动 IDE；若已用 root 启动，改用sudo -u $USER phpstorm.sh - 检查当前用户对
vendor/、composer.lock是否有读写权限（尤其 WSL/Docker 挂载卷场景下，UID/GID 不匹配很常见） - PhpStorm GUI 启动时不加载
.zshrc或.bashrc，所以COMPOSER_HOME等变量可能为空；可在Help → Edit Custom Properties中加一行：idea.config.path=/home/username/.PhpStorm2023.3/config，并确保该路径下options/other.xml里COMPOSER_HOME与终端一致
右键 composer.json 没出现 “Load dependencies” 黄色横幅
这说明 PhpStorm 根本没把当前目录当 PHP 项目处理，或者 composer.json 不在项目根目录——它只认打开项目的顶层目录下的 composer.json，不递归扫描子文件夹。
立即学习“PHP免费学习笔记（深入）”；
- 确认项目是通过
Open → 项目根目录打开的，而不是只打开某个子文件夹或单个composer.json文件 - 检查
File → Project Structure → Project Settings → Project中 SDK 是否设为 PHP（不是 “No SDK”） - 如果项目结构是多根（Multi-root），每个 workspace folder 都需单独含
composer.json，且需分别配置 Composer 路径 - 极少数情况是插件未启用：进
Settings → Plugins，搜Composer，确保已勾选
最常卡住的地方不是“怎么配”，而是以为填了路径就万事大吉——Validate 不过、没重载项目、vendor 被 exclude、Terminal 权限错位，四个环节任意一个断掉，功能就只剩个空壳。
