composer path仓库require失败首要确认路径问题：必须为绝对路径或项目根目录起始的相对路径，指向含合法composer.json的目录，url不能含~、./、../（除非是项目内相对路径如"packages/my-pkg"），末尾严禁加/；验证用cat ~/.composer/config.json | grep -a2 mypkg，确认"type": "path"和干净绝对路径。
Composer path仓库配置后require失败，怎么确认是不是路径问题？
根本不是命令写错了，而是Composer对path类型仓库的路径校验极其严格：它只认绝对路径或项目根目录起始的相对路径，且必须指向一个含合法composer.json的目录。任何偏差都会静默跳过，不报错也不提示。
-
url不能含~、./、../（除非是项目根目录下的相对路径，如"url": "packages/my-pkg"） - 路径末尾**不能加
/**："url": "/home/user/pkg/"会被完全忽略，"url": "/home/user/pkg"才有效 - Windows 用户要避免路径含中文、空格或长路径（某些PHP版本解析会截断）
- 验证方式：运行
cat ~/.composer/config.json | grep -A2 mypkg，确认输出里有"type": "path"和干净的绝对路径
为什么composer install说“Could not find package”，但ls明明能看到本地包？
90% 是name字段不匹配——Composer 不做大小写转换、不支持下划线或驼峰，要求逐字一致。你require写的是"acme/utils"，本地包composer.json里就得是"name": "acme/utils"，多一个空格、大小写错、用_代替-都不行。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 检查本地包根目录下
composer.json是否语法合法（无BOM、无尾逗号、全双引号） - 确认
name值与require中字符串完全相同，包括分隔符和大小写 - 别用
git clone后的路径直接当url——要指向composer.json所在目录，不是src/或lib/ - 临时加个
echo到本地包composer.json里再composer install，如果没报错也没输出，说明该仓库压根没被加载
path依赖能实时生效吗？为什么改了代码类还是not found？
默认不会实时生效——Composer 默认尝试创建符号链接，失败就静默 fallback 到拷贝模式。你改的是源码，运行时加载的却是vendor/里的副本，整个过程不报错。
- 关键点不在主项目配
"symlink": true，而在于**本地包自己的composer.json中必须声明"options": {"symlink": true}** - Windows 用户必须以管理员身份运行终端，否则
symlink创建失败且无提示 - Docker 场景需加
--cap-add=SYS_ADMIN，且挂载方式要透传宿主机权限（-v $(pwd)/pkg:/workspace/pkg不行，要用绑定挂载并确保follow symlinks） - 验证是否真用了链接：
ls -la vendor/acme/utils（Linux/macOS）或dir vendor\acme\utils（Windows），看到->或JUNCTION才是成功
autoload映射没更新，dump-autoload也不生效怎么办？
不是composer dump-autoload失效，而是它只处理已识别的autoload配置。如果path仓库根本没加载，它的autoload段就不会被扫描。
- 先确保path仓库已生效（见前几个副标题），再运行
composer dump-autoload -v，观察输出里是否出现你的命名空间 - 若没出现，说明主项目没读到本地包的
composer.json，回去查repositories配置和路径 - 若出现了但类仍not found，打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀，确认映射路径是绝对路径且对应目录真实存在 - 本地包的
psr-4映射不会自动继承到主项目——主项目得自己在autoload段里加，或靠path仓库的autoload被正确识别
/、本地包composer.json里漏了options、或者Windows没用管理员权限跑终端——这三处任一出错，Composer 都不会告诉你，只会安静地走 fallback 路线。
