Composer路径必须指向真实.phar文件且每次修改composer.json后必须手动Reload project，否则IDE无法识别类、补全失效、右键菜单消失。
Composer executable 路径填错，PHPStorm 就直接“失能”
PHPStorm 不会自动找 composer，它只认你亲手填进去的绝对路径。填错就等于没配——右键菜单消失、Reload project from composer.json 按钮不出现、终端里点“Install”静默失败，连底部状态栏都只悄悄显示 Composer executable not found，不弹窗提醒。
- macOS/Linux：运行
which composer，如果输出是/usr/local/bin/composer，别急着填；再跑ls -l /usr/local/bin/composer，大概率发现它是个 shell wrapper 或软链接，真实composer.phar可能在/opt/homebrew/Cellar/composer/2.7.7/bin/composer.phar这类路径 - Windows：绝不能选
composer.bat（那是启动脚本），必须定位到真正的composer.phar，常见位置是C:ProgramDataComposerSetupincomposer.phar - 项目级安装？可以填
./composer.phar，但得确保文件存在且有执行权限（Linux/macOS 下可能要chmod +x ./composer.phar）
vendor 目录标红、new GuzzleHttpClient() 跳不了 —— 不是没装，是 IDE 没“看见”
哪怕 composer install 成功、vendor/ 里文件齐全，PHPStorm 默认也不会主动扫描它。类找不到、补全失效、Ctrl+Click 跳转失败，90% 是因为 autoload 映射没进索引，不是代码或配置本身有问题。
- 别手贱右键
vendor→Mark Directory as → Excluded（这是高频误操作）；正确做法是先确认它是Not Excluded，再进Settings → PHP → Composer勾上Synchronize IDE settings with composer.json - 改完配置后必须手动触发一次
Reload project from composer.json（右键项目根目录就能看到），否则所有 autoload 规则（比如"psr-4": {"App\": "src/"}）都不会生效 - 如果还标红，试试在 Terminal 里跑
composer dump-autoload -o，再点一次刷新按钮；极端情况可File → Invalidate Caches and Restart → Invalidate and Restart
右键“Run composer command…” 执行成功，但类还是不识别？
执行命令 ≠ 同步索引。PHPStorm 的 Composer 工具窗口或右键菜单只是调用 CLI，它不会自动重载符号表。你点了 Update，composer.lock 和 vendor/ 确实变了，但 IDE 的内部类图没更新，所以旧引用依然报错、新类无法补全。
- 每次修改
composer.json（增删依赖、调整 autoload）后，务必再点一次Reload project from composer.json，哪怕刚执行过 install/update - 如果用的是 Docker 或远程解释器，确保容器内
composer --version可执行，且vendor/目录挂载权限正常（常见报错：Could not write to /var/www/html/vendor） - 检查
Settings → PHP → Interpreter是否指向正确的 PHP 版本（例如php-8.2.12），低版本解释器可能解析不了高版本包里的联合类型或属性语法，导致类加载失败
想让 require、update 这些操作“自动一点”，其实只能半自动
PHPStorm 不是守护进程，它不会监听 composer.json 改动然后默默执行 install。所谓“自动”，只是帮你把命令图形化、参数可视化，减少手敲出错，但触发动作仍需人工干预。
立即学习“PHP免费学习笔记（深入）”；
- 在
composer.json里光标停在包名上按Alt+Enter，能快速查最新版、跳 Packagist、一键require，比切终端快得多 - Tools → Composer → Update dependencies 支持勾选
--with-dependencies或输入laravel/framework:^10.0，参数和 CLI 完全一致，只是有界面预览 - 真正接近“自动”的方式：启用
Synchronize IDE settings with composer.json+ 每次保存composer.json后手动点刷新 —— 没有更省事的办法，也别信插件能全自动 reload
最常被忽略的一点：路径必须指向真实的 .phar 文件，不是软链接、不是 wrapper、不是 bat；其次，reload 动作不是可选项，是必做步骤。这两步漏掉任何一个，整个集成就卡在“看起来配好了，实际用不了”的状态。
