Composer 的 path 仓库是本地多项目协同开发的高效方案，通过在 composer.json 中配置 type 为 path 的本地仓库并启用 symlink 选项，可实现主项目实时加载未发布包代码；需注意版本匹配、路径有效性及上线前移除配置。
Composer 的 path 仓库是本地多项目协同开发的高效方案，特别适合在调试自研 Composer 包（如私有 SDK、通用组件）时，让主项目实时加载未发布、正在修改中的包代码，无需反复 composer update 或手动 symlink。
配置 path 类型仓库
在主项目的 composer.json 中，通过 repositories 声明一个类型为 path 的本地仓库，指向你正在开发的包目录：
{
"repositories": [
{
"type": "path",
"url": "../my-sdk"
}
],
"require": {
"acme/my-sdk": "*"
}
}
注意：url 必须是相对于当前 composer.json 文件的路径，且该路径下需存在合法的 composer.json（含 name 和 version）。
启用软链接模式（推荐）
默认情况下，Composer 会将 path 包复制到 vendor/ 目录。若希望直接引用源码（改即生效），需在 repositories.path 中添加 "options": {"symlink": true}：
{
"type": "path",
"url": "../my-sdk",
"options": {
"symlink": true
}
}
执行 composer install 或 composer update acme/my-sdk 后，vendor/acme/my-sdk 将变为指向 ../my-sdk 的符号链接，IDE 跳转、断点调试、Git 提交均直接作用于源目录。
版本匹配与开发稳定性
path 仓库不绕过版本约束，主项目中 "acme/my-sdk": "*" 仍会匹配包内 composer.json 中声明的 version（如 "1.0.0"）。为避免因版本号未更新导致安装失败或降级，建议：
- 开发阶段将包的
version设为dev-main或dev-develop（对应分支名） - 主项目中明确写
"acme/my-sdk": "dev-main"，确保 Composer 精确识别 - 如需强制使用最新本地代码，可运行
composer update acme/my-sdk --with-all-dependencies
多包协同与注意事项
多个本地包可共存于同一 repositories 数组中，各自独立配置 path 和 symlink。需注意：
- 路径必须真实存在，否则
composer install会报错退出 - 被链接的包目录不应包含
vendor或已安装依赖，否则可能引发自动加载冲突 - 上线前务必移除或注释
path配置，并切换回 Packagist 或私有仓库地址，避免误用本地路径发布
