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 不生效，根源就在这儿。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(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 之间最常断连的地方。