composer path仓库需在根composer.json配置repositories为"type":"path"，url用相对路径，子包name须与require键完全一致，且子包composer.json必须含name和autoload；修改本地代码后需删vendor目录重装或用composer update --with-dependencies同步。
Composer 的 path 仓库类型怎么配才不翻车
直接用 path 仓库是 Monorepo 下最轻量、最可控的本地包引用方式，但它极其依赖路径拼写和包名一致性。一旦配错，composer install 不报错但实际加载的是 Packagist 上同名远程包——这是最隐蔽的坑。
实操要点：
-
repositories必须写在根项目composer.json里，不能只写在子包里；类型必须是"type": "path"，不是"package" - 路径值（
url字段）必须是相对于根composer.json的相对路径，比如"url": "packages/my-utils"，不能以./开头，也不能写绝对路径 - 子包自身的
name（如"acme/my-utils"）必须和根项目中require的键完全一致，大小写、连字符都不能差 - 子包目录下必须有合法的
composer.json，且至少含name和autoload；空文件或缺autoload会导致类找不到，但composer install仍成功
为什么 composer update 总是忽略本地修改
常见现象：改了 packages/my-sdk/src/Client.php，运行 composer update 或 composer dump-autoload 后，vendor/acme/my-sdk 里还是旧代码——因为 Composer 默认把 path 包当成“已安装”，不会自动同步文件变更。
真正生效的操作只有两个：
- 手动执行
composer update acme/my-sdk --with-dependencies（注意加--with-dependencies，否则可能跳过） - 或者更稳妥：删掉
vendor/acme/my-sdk目录，再跑一次composer install，强制重新软链接
别信 composer dump-autoload，它只刷新自动加载映射，不触发包内容同步。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
autoload-dev 在 Monorepo 里为什么总失效
子包的测试类（比如 tests/MyTest.php）无法被根项目的 phpunit 找到，根本原因是：Composer 只会加载根项目 autoload-dev 和已安装包的 autoload-dev，但 path 类型包的 autoload-dev 默认不启用。
解决办法只有一条路：
- 在根项目
composer.json的autoload-dev里，显式加上子包的测试路径，例如："autoload-dev": {<br> "psr-4": {<br> "Acme\MySdk\Tests\": "packages/my-sdk/tests/"<br> }<br>} - 不要指望子包自己的
autoload-dev自动合并进来；Composer 不做跨包 autoload 合并 - 如果子包要独立运行测试，它得有自己的
composer.json+autoload-dev，但根项目调用时仍需上面那条配置
要不要用 composer link 或插件替代 path 仓库
结论：不用。官方没 composer link 命令，第三方插件（如 hirak/prestissimo 或 bmitch/changeling）要么过时，要么增加构建不确定性。Monorepo 的核心诉求是「可预测」和「CI 友好」，而插件往往绕过标准流程，导致本地能跑、CI 报错。
真正值得投入的点只有两个：
- 用
composer config --global repo.packagist composer https://packagist.org确保所有环境走同一源，避免私有镜像污染path解析 - 在 CI 脚本里固定使用
composer install --no-interaction --prefer-dist，禁用开发模式下的软链接行为，防止缓存污染
复杂点从来不在工具链，而在路径、命名、autoload 三者之间那几处不声不响的耦合。盯紧这三处，比换十个插件都管用。
