Monorepo 中用 Composer 管理依赖的核心是配置 path 类型仓库，使根项目优先加载本地子包而非远程同名包；需在根 composer.json 的 repositories 中声明 "type": "path" 和匹配路径，子包需含正确 name、autoload 等字段，安装后 vendor 中为符号链接，实现改代码即生效。
在 Monorepo 项目中用 Composer 管理依赖，核心不是“禁用 Composer”，而是绕过 Packagist 默认分发逻辑，改用本地路径（path）仓库精准加载子包。关键在于让根项目能识别并优先拉取本地开发中的子包，而不是远程同名版本。
Path 仓库的本质：把本地目录伪装成 Composer 包源
Composer 本身不区分“单体”或“多体”，它只认 composer.json 和仓库配置。Path 仓库就是告诉 Composer：“这个路径下有个合法的包，它的 name、version、autoload 都以它自己的 composer.json 为准。” 不需要发布、不需要 Git tag、不走网络请求——纯本地映射。
- 路径必须包含有效的
composer.json（有name字段，且格式正确） - 路径支持相对路径（如
../../packages/my-utils）或绝对路径（慎用，影响协作） - Composer 会自动检测该目录下是否有
composer.json，并将其注册为一个可安装的包源
在根项目中声明 Path 仓库
在 Monorepo 的根目录（即主 composer.json 所在处）添加 repositories 配置：
{
"repositories": [
{
"type": "path",
"url": "packages/*"
}
],
"require": {
"myorg/utils": "*",
"myorg/api-client": "dev-main"
}
}
-
"packages/*"是通配写法，匹配packages/下所有含composer.json的子目录 - 通配符只支持一层（
packages/**不生效），多级需显式列出或用多个 path 条目 - 子包的
name必须与require中一致，否则无法命中 - 版本约束写
"*"表示接受任意本地版本（包括无 version 字段的包），写"dev-main"则要求子包composer.json中有"version": "dev-main"或分支名为 main
子包 composer.json 的最小必要配置
每个子包（如 packages/utils/composer.json）至少要包含：
{
"name": "myorg/utils",
"type": "library",
"autoload": {
"psr-4": {
"MyOrg\\Utils\\": "src/"
}
}
}
-
name必须全局唯一，建议统一命名空间前缀（如myorg/xxx） -
type可选，但设为library更利于工具识别 -
autoload是重点：确保 PSR-4 映射路径正确，且与实际文件结构一致 - 无需写
version字段——Composer 会用 Git 分支/提交信息动态推断；若需固定行为，可加"version": "dev-main"
日常开发与安装流程
执行 composer install 或 composer update 时：
- Composer 先扫描所有
repositories中的 path 目录，收集可用包列表 - 根据
require中的包名和版本约束，在本地路径中匹配候选 - 匹配成功后，直接 symlink（Linux/macOS）或 copy（Windows，默认）该目录到
vendor/myorg/utils - 后续
composer update myorg/utils仅刷新 symlink，不重新下载——真正实现“改完即用”
注意：首次安装后，vendor 中的包是符号链接（非副本），所以你在 packages/utils/src/ 改代码，vendor/myorg/utils/src/ 立刻同步可见——调试零延迟。
基本上就这些。Path 仓库不是黑魔法，只是让 Composer “睁眼看见本地目录”。只要路径对、name 对、autoload 对，Monorepo 就能像普通项目一样平滑依赖管理。
