Path仓库是Composer将本地目录映射为单一包源的机制，不支持子包嵌套，因其仅识别显式声明路径下的composer.json，不会递归扫描或通配匹配子目录。
什么是Path仓库，它为什么不能直接支持子包嵌套
Composer 的 path 类型仓库本质是本地文件系统映射，它只认「一个路径对应一个包」——也就是说，composer.json 所在目录必须是该包的根目录。如果你把多个子包（比如 vendor/myorg/package-a、vendor/myorg/package-b）全塞进同一个父目录（如 packages/），Composer 不会自动扫描子目录；它只会尝试读取你显式声明的路径下的 composer.json。
正确做法：每个子包独立声明为 path 仓库
必须为每个子包单独配置一条 repositories 记录，且每条记录的 url 指向该子包自己的根目录（即包含其 composer.json 的目录）。例如：
{
"repositories": [
{
"type": "path",
"url": "../packages/package-a"
},
{
"type": "path",
"url": "../packages/package-b"
}
],
"require": {
"myorg/package-a": "dev-main",
"myorg/package-b": "dev-main"
}
}
注意以下几点：
-
url必须是相对路径（从当前项目composer.json所在位置出发），且不能以/开头或含..超出项目范围（否则 Composer 会拒绝加载） - 每个子包的
name字段（如"myorg/package-a"）必须与require中的包名严格一致，大小写敏感 - 版本约束推荐用
dev-main或dev-develop，避免写死1.0.0—— 否则 Composer 可能忽略本地修改，坚持拉取已发布的版本
常见错误：试图用通配符或 glob 匹配多个子包
有人会尝试写 "url": "../packages/*" 或依赖 Composer 自动发现，这完全无效。Composer 不解析通配符，也不递归扫描 path 仓库目录。你将遇到如下错误：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
[InvalidArgumentException] Package myorg/package-a has a PHP requirement incompatible with your PHP version（实际是根本没找到包，Composer 退而求其次去 Packagist 查，结果版本不匹配）
或者更隐蔽的情况：composer install 成功但实际加载的是 Packagist 上的老版本——因为本地仓库未命中，Composer 默默回退了。
进阶技巧：用脚本动态生成 repositories 配置
当子包数量较多（>5 个）时，手动维护 repositories 易出错。可写一个简单 shell 脚本或 PHP 小工具，遍历 ../packages/ 下所有含 composer.json 的目录，生成 JSON 片段。但要注意：
- 生成后仍需手动合并进主
composer.json，Composer 不支持外部引用或 include - CI 环境中要确保这些 path 目录存在且权限可读，否则
composer install会失败 - Git 提交时记得把子包目录加入
.gitignore的例外（如果它们本身是独立 Git 仓库），否则容易误提交二进制或锁文件
真正麻烦的从来不是配置几行 JSON，而是团队成员是否都清楚：本地 path 仓库不参与版本发布流程，上线前必须切换回真实源（如私有 Packagist 或 Git URL），否则部署会直接失败。
