Composer 识别 monorepo 本地包需在根 composer.json 的 repositories 中显式声明 path 类型仓库，url 必须为相对于根目录的路径（如 "../packages/foo"），子包 name 需全限定，version 设为 "dev-main" 或 "*@dev"，并启用 "options": {"symlink": true} 确保实时联动。
Composer 本身不原生支持 Monorepo 多包协同开发，直接用 composer install 会把每个子包当作独立项目处理，导致依赖解析冲突、版本不一致、本地包无法实时联动。必须通过组合策略绕过限制，核心是「让 Composer 认出本地路径包，并控制其加载顺序与版本约束」。
如何让 Composer 识别 monorepo 内的本地包？
关键在根 composer.json 的 repositories 配置 —— 必须显式声明每个子包为 path 类型仓库，且路径需相对于根目录（不是当前工作目录）。
- 子包目录如
packages/foo，其composer.json中的name必须是合法的全限定名（如myorg/foo），不能是foo -
repositories中的url值要写成"../packages/foo"（注意双点开头），而非"packages/foo"；否则 Composer 会尝试从当前命令执行目录解析，极易失败 - 所有子包的
version字段建议设为"dev-main"或"*@dev"，避免因版本号硬编码导致 require 失败
{
"repositories": [
{
"type": "path",
"url": "../packages/foo"
},
{
"type": "path",
"url": "../packages/bar"
}
],
"require": {
"myorg/foo": "*@dev",
"myorg/bar": "*@dev"
}
}
为什么 composer update 有时不拉取本地修改？
Composer 缓存了包的元数据和 dist 源，即使配置了 path 仓库，它仍可能优先使用旧的已安装版本或远程镜像缓存，跳过本地文件读取。
- 每次修改子包源码后，必须运行
composer update myorg/foo --with-dependencies，强制重新解析该包及其依赖链 - 禁用 dist 模式：加
--prefer-source参数确保始终检出本地路径，而不是尝试下载 zip 包 - 清除缓存不是万能解法：
composer clear-cache只清元数据，若已安装过旧版本，还需rm -rf vendor/myorg/foo再重装
如何避免子包间循环依赖和 autoload 冲突？
Monorepo 中多个包共享命名空间或互相 require 时，Composer 的自动加载机制容易错乱，尤其当两个包都声明了相同 PSR-4 前缀（如 "MyOrg\\": "src/"）。
- 每个子包的
autoload必须严格限定自身目录，例如"MyOrg\\Foo\\": "src/"，绝不能写成"MyOrg\\": "src/" - 根项目无需定义 autoload，它只作为协调者；所有类加载应由各子包自己声明并被 Composer 合并处理
- 若某子包需临时引用另一个子包的开发中代码（非通过 require），可用
autoload-dev+files引入辅助脚本，但不可用于正式依赖
最易被忽略的是路径仓库的 options.symlink 设置 —— 默认为 false，意味着 Composer 会复制整个子包目录到 vendor/，导致你改了 packages/foo 却没生效。务必在 repositories 条目里加上 "options": {"symlink": true}，否则所谓「本地开发」只是幻觉。
