Composer 的 path 类型仓库是本地开发私有包最直接、最轻量的方式，通过配置 repositories 指向本地路径并设 "symlink": true 实现改即生效；需确保路径正确、name 匹配、权限正常。
Composer 的 path 类型仓库是本地开发私有包最直接、最轻量的方式——它让 Composer 把本地文件夹当作一个可安装的包源，无需每次改完代码都重新打包、推送、更新版本号，真正实现“改即生效”。
配置 path 仓库的基本结构
在项目根目录的 composer.json 中添加 repositories 配置，指向你本地包的路径：
{
"repositories": [
{
"type": "path",
"url": "../my-awesome-package"
}
],
"require": {
"vendor/my-awesome-package": "*"
}
}注意两点：
- url 是相对于当前 composer.json 文件的路径，支持相对路径（推荐）或绝对路径；
- 包名（vendor/my-awesome-package）必须与被引用包自身 composer.json 中的 name 字段完全一致；
- 版本约束写 "*" 即可，Composer 会自动识别该路径下 composer.json 中的 version 或使用 dev-main（若为分支）。
启用 symlink 模式提升开发体验
默认情况下，Composer 会把本地包复制进 vendor/，改代码后需手动重新 install。开启 symlink 后，Composer 直接创建符号链接，编辑本地源码立刻反映到项目中：
- 在
repositories条目中增加"options": { "symlink": true }； - 确保你的系统支持符号链接（Linux/macOS 默认支持，Windows 需启用开发者模式或以管理员运行终端）；
- 执行
composer update vendor/my-awesome-package触发重链接（首次安装也生效）。
验证是否成功：进入 vendor/vendor/my-awesome-package，用 ls -la（macOS/Linux）或 dir（Windows）查看是否为链接而非普通文件夹。
配合 autoload-dev 和脚本快速调试
本地包常需独立测试，建议在它的 composer.json 中合理配置：
-
"autoload-dev"声明测试类路径，如"tests/": "tests/"； -
"scripts"加入一键命令，例如"test": "phpunit"； - 主项目中无需额外操作——因为 symlink 已让代码实时同步，直接在主项目里运行
vendor/bin/phpunit或调用包内类即可验证修改效果。
小技巧：如果包里用了 __DIR__ 或文件路径相关逻辑，注意 symlink 不影响运行时路径解析，PHP 仍会按真实文件位置工作，无需特殊处理。
常见问题与绕过方式
遇到安装失败？先检查这几个点：
- 路径拼写错误（尤其 Windows 下反斜杠、大小写敏感）；
- 本地包缺少
composer.json，或其中name与主项目require不匹配； - 权限问题导致无法创建 symlink（macOS/Linux 可试
sudo composer update临时排查，但不推荐长期使用）； - 已存在同名包且被缓存，运行
composer clear-cache再重试。
不想全局启用 symlink？可以只对某个包启用："options": { "symlink": true } 放在对应 repository 下，不影响其他仓库。
