PhpStorm中Composer集成失败主因是composer.json未被识别或可执行路径错误：需手动指定真实.phar路径并Validate验证，右键composer.json选“Add as Composer Project”，改配置后必须手动Reload project from composer.json。
PhpStorm 里 Composer 集成失败，90% 不是插件没开、也不是网络问题，而是 composer.json 没被识别为项目入口，或 composer 可执行路径根本没对上——IDE 不会自动猜，必须手动“指认”。
Composer executable 路径填错，整个集成就失效
PhpStorm 默认不继承系统 PATH，也不会自动找 composer。填错路径后，右键菜单消失、Reload project from composer.json 按钮不出现、终端点 Install 静默失败，状态栏只悄悄显示 Composer executable not found。
- macOS/Linux：运行
which composer，但别直接填结果；再用ls -l $(which composer)看它是不是软链接，真实路径常在/opt/homebrew/Cellar/composer/2.7.7/bin/composer.phar这类位置 - Windows：必须指向
composer.phar文件本身（如C:\ProgramData\ComposerSetup\bin\composer.phar），不是composer.bat—— 后者只是启动脚本，IDE 调用时容易因 shell 环境不一致失败 - 填完务必点
Validate按钮；失败说明路径错、权限不足，或该文件根本不是可执行的 PHP 脚本 - 项目级安装？可填
./composer.phar，但得确保文件存在且有执行权限（Linux/macOS 下需chmod +x ./composer.phar）
右键“Add as Composer Project” 才是激活起点
PhpStorm 不会主动扫描子目录下的 composer.json。即使你整个 Git 仓库都打开了，而 composer.json 在 packages/foo/ 里，IDE 就当它不存在——右键菜单灰掉、补全失效、autoload 不生效，根源就在这儿。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 必须在
composer.json文件上右键 → 选Add as Composer Project - 如果没这个选项，先去
Settings → Languages & Frameworks → PHP → Composer确认Path to composer.phar已填且通过Validate - Windows 用户慎用 Git Bash 自带的
composer，优先用全局安装的composer.phar或官方 installer 提供的路径 - 改完
composer.json后，IDE 不会自动 reload —— 必须再次右键该文件或项目根目录，手动点Reload project
vendor 目录标红 ≠ 没装好，是 autoload 没进索引
哪怕 composer install 成功、vendor/autoload.php 存在、new GuzzleHttpClient() 在浏览器里能跑，PhpStorm 依然标红、Ctrl+Click 跳不到源码——这不是代码问题，是 IDE 的符号索引没刷新。
- 别右键
vendor→Mark Directory as → Excluded（高频误操作！）；应确保它是Not Excluded - 勾选
Settings → PHP → Composer → Synchronize IDE settings with composer.json，但它只同步 autoload 规则，不触发索引重建 - 最关键的一步：右键项目根目录 →
Reload project from composer.json（小刷新图标），强制重读autoload并重建符号表 - 仍不识别？在 Terminal 里运行
composer dump-autoload -o，再点一次刷新；极端情况可Invalidate Caches and Restart
类跳转失败？大概率是用了 dist 包而非源码
默认 composer install 下载的是压缩包（dist），不含 Git 信息和完整目录结构。PhpStorm 只能跳到 vendor/autoload.php 的 require 行，无法定位原始类定义位置。
- 解决办法：用
composer install --prefer-source，每个包都是git clone下来的，含完整源码和分支信息 - 已有项目补救：删掉
vendor，再运行composer install --prefer-source - 注意部分包（如某些私有仓库或 legacy 包）可能不支持
--prefer-source，会 fallback 到 dist - 若跳转仍异常，检查
composer.json中"autoload"的 PSR-4 映射路径是否与实际目录结构一致（比如写的是"App\": "src/"，但类文件实际在app/下）
最易忽略的一点：每次修改 composer.json（增删依赖、调整 autoload、改 platform 版本），都必须手动 Reload project from composer.json——执行命令 ≠ 同步索引，这是 PhpStorm 和 Composer 之间最常断连的地方。
