Composer通过path仓库实现Monorepo：需满足三点——url指向含composer.json的子目录、子包name与require完全一致、require用"@dev"而非版本约束，安装后生成符号链接实现代码实时生效。
Composer 本身不原生支持 Monorepo，但通过 path 类型仓库 + 合理的 composer.json 结构，就能让单体仓里多个模块互相依赖、实时联动，且不发布也能开发调试。
为什么不能直接用 require "vendor/package"？
因为 Composer 默认只认 Packagist 或自定义远程源，本地目录不是“包”，也不会自动加载其 autoload 规则。强行复制粘贴代码或手动 symlink 会破坏命名空间隔离、导致 PSR-4 自动加载失效，且每次改子包都要 composer dump-autoload —— 这不是 Monorepo，是手工运维。
真正可行的做法是：让每个子模块都带合法 composer.json（含 name 和 autoload），再在根项目中用 repositories 显式声明它们为本地包源。
如何配置 path 仓库才能生效？
关键不在“加了 repositories”，而在三点是否同时满足：
-
repositories中的url必须指向含composer.json的**具体目录**（如"services/user-service"），不能只写"services/*"—— 后者仅在 Composer 2.2+ 支持，且需确保该路径下每个子目录都有合法composer.json - 子包的
composer.json必须有非空name字段，且格式正确（例如"acme/user-service"）；名字必须与根项目require中的包名完全一致 - 根项目的
require里不能写"acme/user-service": "^1.0"这类带版本约束的写法——本地path包不走版本解析，应统一用"@dev"，否则 Composer 会跳过本地源去远程找匹配版本
示例根 composer.json 片段：
{
"repositories": [
{ "type": "path", "url": "services/user-service" },
{ "type": "path", "url": "packages/logging" }
],
"require": {
"acme/user-service": "@dev",
"acme/logging": "@dev"
}
}
安装后 vendor 里为什么是符号链接？
这是 path 仓库的默认行为，也是 Monorepo 开发效率的核心：运行 composer install 后，vendor/acme/user-service 实际指向 services/user-service 目录。改子包代码，主项目立刻可见，无需重复 install 或 dump-autoload。
但要注意：
- 符号链接在 Windows 上需管理员权限启用（
mklink），否则 Composer 会 fallback 成硬拷贝，失去热更新能力 - 某些 CI 环境禁用符号链接（如部分 Docker 镜像），此时需在
repositories中加"options": { "symlink": false }，并接受拷贝延迟 - 如果你在子包里用了
__DIR__计算路径（比如加载配置文件），要意识到它指向的是vendor/...下的链接目标，不是原始目录 —— 这和你预期可能不一致
autoload 冲突和命名空间怎么避坑？
所有子包必须共用一套 PSR-4 前缀规则，比如全部以 Acme\ 开头，且各自 autoload 的映射路径不能重叠。常见错误是：
- 子包 A 定义
"Acme\UserService\": "src/"，子包 B 也定义"Acme\UserService\": "lib/"→ 加载器会随机选一个，行为不可控 - 根项目自己也写了
autoload，又没排除子包目录，导致同一类被注册两次 →Class 'X' not found或Cannot declare class - 子包用了
classmap或files类型 autoload，而根项目未执行composer dump-autoload --optimize→ 那些文件不会被自动包含
建议做法：根项目 autoload 只负责自身逻辑；所有子包独立管理自己的 autoload，并通过 Composer 自动合并 —— 这要求每个子包的 composer.json 都正确声明，且无命名空间交叠。
最易被忽略的一点：子包的 name 字段不仅用于 require，还隐式决定了其自动加载根命名空间。比如 "name": "acme/user-service" 对应 Acme\UserService\，大小写必须与实际类文件路径严格一致，否则 PSR-4 加载失败。
