使用 path 仓库可临时加载本地包，无需修改根 composer.json：运行 composer config repositories.local path “./packages/my-package” 后执行 composer require vendor/name:dev-main 即可安装；路径须指向含有效 composer.json 的目录，且需注意 autoload、缓存及清理残留。
用 path 仓库类型临时加载本地包，无需改 composer.json 根配置
直接在项目根目录下运行 composer config repositories.local path "./packages/my-package"，就能让 Composer 知道本地有个包可装。这不会碰你原来的 composer.json，所有改动只存在 composer.json 的 repositories 字段里（Composer 会自动写入）。后续执行 composer require vendor/name:dev-main 就能装进去。
常见错误现象：执行完 config 命令后 require 报错 “Could not find package”，大概率是路径没对上——path 值必须指向含 composer.json 的目录，且该文件里得有正确的 name 和 version（或 dev- 开头的分支名）。
-
path值支持相对路径，但不能以../跨出项目根（Composer 会拒绝） - 本地包的
composer.json中autoload配置必须有效，否则类找不到 - 如果本地包已通过其他方式安装过，先
composer remove vendor/name再重试，避免缓存干扰
为什么不用 composer create-project 或 git clone？
因为那两种方式绕过了 Composer 的依赖解析机制：前者生成全新项目，后者只是把代码拉下来，不注册为可 require 的包。而 path 仓库是 Composer 官方支持的“伪远程源”，它让本地目录被当作一个可搜索、可约束版本、可参与依赖图计算的包源。
典型使用场景：调试刚写的私有 SDK、验证某个 fork 分支是否修复了 bug、给同事快速共享未发布到 Packagist 的组件。
- 性能上几乎无损耗——Composer 不下载也不解压，直接符号链接（linux/macos）或复制（windows）
- 兼容性好，PHP 7.2+ 和 Composer 2.0+ 均支持，不需要额外插件
- 注意 Windows 下若启用
COMPOSER_DISABLE_XDEBUG_WARN=1，可能跳过 symlink 提示，实际仍是 copy 行为
path 仓库和 package 仓库的区别在哪？
path 是动态读取本地文件系统，package 是静态声明一个“假包”（需手动写 name/version/dist 等字段），后者连本地目录都不需要，但维护成本高、无法热更新、autoload 易出错。
参数差异明显：path 只要一个路径字符串；package 得写一整段 JSON 描述，稍有拼写错误就导致 composer install 失败。
- 错误信息如
[RuntimeException] Could not load package xxx in packages，基本就是package声明格式不对 -
path仓库修改后，下次composer update自动生效；package改了得手动删vendor/composer/installed.json缓存才可能刷新 - CI 环境中
path仓库会被忽略（因路径不存在），而package仓库仍可用——这是唯一package更稳的点
删掉本地仓库配置时容易漏掉什么？
运行 composer config --unset repositories.local 确实能删掉配置，但如果你之前 require 过这个包，它的记录还在 composer.lock 里，而且 vendor/ 下的文件不会自动清理。
真正干净的做法是三步走：
- 先删配置：
composer config --unset repositories.local - 再删锁文件中的残留引用：
composer update vendor/name --with-dependencies（或干脆删composer.lock后重装） - 最后手动确认
vendor/vendor/name目录是否还存在，存在就rm -rf掉
最常被忽略的是第三步——尤其当本地包用了 symlink，vendor/ 里看着像文件夹，其实是链接，不清理会导致后续 composer dump-autoload 找到旧类、报奇怪的 class not found。