Composer 的 path 类型仓库支持本地开发调试私有包，通过在 composer.json 的 repositories 中配置 type 为 path 的本地路径，使修改即生效；需确保本地包含有效 composer.json（含正确 name、推荐 dev-main 版本及合理 autoload），默认创建符号链接（Linux/macOS）或复制（Windows），可禁用以回退 Packagist。
在 Composer 中使用 path 类型仓库，是本地开发调试私有包最直接高效的方式——它让 Composer 把你本地文件夹当作一个可安装的包源，无需每次改完都 push、tag、更新版本号，改完即生效。
配置 path 仓库的基本方式
在项目根目录的 composer.json 中，通过 repositories 字段添加一个 type 为 path 的仓库，并指定其路径（支持相对或绝对路径）：
示例：将同级目录 my-package 作为本地包源
{
"repositories": [
{
"type": "path",
"url": "../my-package"
}
],
"require": {
"vendor/my-package": "*"
}
}
注意：vendor/my-package 必须与 my-package/composer.json 中定义的 name 完全一致；"*" 表示接受任意稳定版本（包括 dev-main），Composer 会自动识别该路径下的 composer.json 并读取其 version 或分支信息。
确保本地包能被正确识别和加载
你的本地包（如 ../my-package）必须包含有效的 composer.json，且满足以下条件：
-
name 字段必须存在且格式正确（如
acme/utils），不能含空格或非法字符 -
version 可省略，但建议设为
"dev-main"或"@dev"，便于明确开发状态 -
autoload 配置要合理，例如用
"psr-4": {"Acme\\": "src/"}，否则类无法自动加载 - 若包中含
bin文件，需在主项目运行composer install后才会软链接到vendor/bin/
开发时的常用操作与技巧
启用 path 仓库后，日常开发更灵活：
- 修改本地包代码后，无需重新
composer update—— 自动生效（因是符号链接或硬拷贝，取决于path仓库的options配置） - 默认情况下，Composer 会为 path 包创建符号链接（Linux/macOS）或复制（Windows），你可在仓库配置中强制启用软链：
"options": {"symlink": true} - 想临时禁用 path 源？注释掉
repositories里的对应项，再运行composer update vendor/my-package，就会回退到 Packagist 正式版 - 调试依赖解析问题？加
-vvv参数运行composer require或update，可看到 Composer 实际匹配的是哪个路径
注意事项和常见坑
path 仓库虽方便，但容易踩坑：
-
路径必须真实存在且可读，否则
composer install会报错“Package not found” -
不要在
path仓库里写require自身或其他 path 包，易引发循环依赖或解析混乱 -
提交到 Git 时，建议把
repositories配置放在composer.json中，但提醒团队成员同步维护本地路径结构；也可用composer.json.dist+ 脚本生成带 path 的正式版 - CI 环境通常不适用 path 仓库，上线前务必移除或用环境变量控制是否启用
基本上就这些。path 类型仓库不是黑魔法，而是 Composer 对本地开发场景的务实支持——只要路径对、配置清、 autoload 准，改一行代码就能立刻在主项目里验证效果。
