Path仓库通过本地目录引入包，优先使用目标composer.json中的version字段匹配require约束；若版本不满足则报错，建议显式声明版本并启用symlink以提升开发效率。
当你在 Composer 中使用 "path" 类型的仓库时，版本约束的处理方式与从 Packagist 或 VCS 仓库安装依赖有所不同。理解其机制有助于避免意外行为。
Path 仓库的基本原理
path 仓库指向本地文件系统中的一个目录，通常用于开发中测试包或内部私有组件。它通过软链接（symlink）或复制文件的方式将包引入项目。示例配置：
{
"repositories": [
{
"type": "path",
"url": "../my-package"
}
],
"require": {
"vendor/my-package": "*"
}
}
版本约束如何被处理
Composer 在解析 path 仓库时，并不会严格校验 version 字段是否满足require 中的约束，而是优先使用目标目录中 composer.json 定义的版本。
关键点：
- 如果本地包的 composer.json 中 version 为
"1.2.0"，而主项目 require 的是"^1.0"，则匹配成功。 - 若本地包 version 为
"0.5.0"，而 require 的是"^1.0"，Composer 会报错：无法满足版本约束。 - 如果你设置 require 版本为
"*"，则任何版本都会被接受（但仍需存在 version 字段或能推断出版本）。
启用符号链接（推荐开发使用）
为了在开发中实时修改包代码并立即反映到主项目，建议启用 symlink：{
"config": {
"preferred-install": {
"vendor/my-package": "source"
}
}
}
或全局设置：
{
"repositories": [
{
"type": "path",
"url": "../my-package",
"options": {
"symlink": true
}
}
]
}
开启后，Composer 会尝试创建软链接而非复制文件，提升开发效率。
版本未定义时的行为
如果 path 指向的包没有定义 version，Composer 会尝试从 Git 分支或标签推断（如dev-main），但这种情况下：
- require 中必须使用对应的开发版本约束，例如
"dev-main"或"dev-develop"。 - 若 require 写的是
"^1.0"，而包无明确版本且无法推断为稳定版，安装会失败。
建议始终在本地包中显式声明 version，避免歧义。
基本上就这些。只要注意本地包的 version 字段与主项目的 require 匹配，path 仓库就能正常工作，特别适合本地调试和私有组件开发。
