多个path仓库可共存，需确保每个url指向独立含composer.json的目录、路径相对项目根且不重复、name字段唯一；require中直接按包名引用，无需特殊语法。
多个 path 仓库能共存，但顺序和路径必须唯一
Composer 允许你在 composer.json 的 repositories 数组里定义多个 "type": "path" 条目，只要每个 url 指向的本地目录是独立且有效的包（含自己的 composer.json），就能同时加载。关键不是“能不能加”，而是“加得对不对”。
常见错误是把两个 path 指向同一目录，或路径写成相对主项目根目录的错误层级（比如少写一个 ../），导致 Composer 找不到包、报 Could not find package xxx at any version。
-
url必须是相对于当前项目根目录的路径，不能是绝对路径（如/home/user/pkg） - 每个
path的目标目录下必须有合法的composer.json，且name字段不能重复（否则后声明的会覆盖前声明的） - 多个
path在数组中按从上到下顺序检查，但仅影响同名包的优先级；不同名包互不干扰
require 里怎么写多个本地包？直接列名字 + 版本约束
只要你在 repositories 里注册了多个 path，它们就和 Packagist 上的包一样可被 require 引用——不需要额外语法，也不需要加前缀或特殊标记。
例如你注册了 ../my-auth 和 ../my-logger 两个本地包，它们的 name 分别是 acme/auth 和 acme/logger，那 require 就这么写：
"require": {
"acme/auth": "*",
"acme/logger": "dev-main"
}
注意：* 表示取该本地包 composer.json 中定义的 version 或默认解析为 dev-main；若想明确指向某个分支，用 dev-feature/x 即可，无需改 repositories 配置。
- 版本约束写
*最安全，因为本地path包不走语义化版本校验，只认当前目录状态 - 不要在
require里写本地路径（如"../my-auth": "*"），这是无效语法 - 如果某个包装不上，先运行
composer show acme/auth看是否识别到，再查composer diagnose输出的仓库列表
符号链接 vs 复制：开发时默认软链，但要注意 IDE 和文件监视
Composer 对 path 类型仓库默认使用符号链接（symlink），这意味着你改本地包源码，主项目立刻可见——这对调试极友好。但这也带来几个容易忽略的实际问题：
- Windows 用户需确认启用了开发者模式或以管理员身份运行终端，否则
symlink创建失败，Composer 会静默 fallback 到复制模式 - 某些 IDE（如 PHPStorm）默认不跟随 symlink，需在设置里开启「Follow symbolic links」，否则跳转定义失效
- 文件监视工具（如
inotifywait、Laravel Mix 的 watch）可能不监听 symlink 目标目录，需手动把监听路径指向源码所在的真实路径 - 如果你真需要复制而非链接（比如 Docker 构建时避免挂载冲突），可在
config里加："config": { "preferred-install": { "acme/*": "dist" } }，但开发阶段一般不用
autoload 冲突最容易发生在 PSR-4 命名空间重叠时
多个本地包各自声明 psr-4 自动加载规则没问题，但一旦它们的命名空间前缀相同（比如都映射 App\），而路径又没严格隔离，就会出现类加载错乱：A 包里的 App\Service\Foo 可能被 B 包的同名文件覆盖。
这不是 Composer 的 bug，而是 PSR-4 规则本身决定的——自动加载器按注册顺序查找，先注册的路径优先。
- 每个本地包的
autoload.psr-4键名必须唯一，推荐用带厂商前缀的命名空间，如"Acme\Auth\": "src/" - 主项目的
autoload不要和本地包的命名空间交叉，尤其避免用空命名空间（""）映射整个src/，它会吃掉所有未匹配的类名 - 运行
composer dump-autoload -o后，可检查vendor/composer/autoload_psr4.php文件，确认各包的映射是否按预期写入
实际协作中，最常卡住的地方不是配置写法，而是团队成员忘记在本地把对应路径的包 clone 下来，或者路径写死了自己机器上的绝对位置。所以建议在项目 README 里明确列出所有依赖的本地包路径，并用 composer install 失败时的错误信息作为第一排查线索。
