path仓库type必须为"path"，误写为package或vcs将导致Composer跳过该包；url须为相对路径且指向含合法composer.json的目录；require中仅"*"有效，版本约束实际无效。
path仓库的type必须设为path，不是package或vcs
Composer识别本地路径依赖的核心是type: "path"。如果误写成"type": "package"，即使路径存在，composer install也会跳过该包、不链接，甚至报Package ... is not installed错误。
正确配置示例（写在根项目composer.json的repositories中）：
{
"repositories": [
{
"type": "path",
"url": "../my-shared-lib"
}
],
"require": {
"acme/my-shared-lib": "*"
}
}
注意：url值是相对于当前composer.json文件的路径，不是相对于命令执行目录。
-
url支持../、./、../../subdir/等标准相对写法，但不能以/开头（否则变绝对路径，跨环境易失效） - 若
url指向目录不含composer.json，会报Could not find package acme/my-shared-lib at version * - 路径中不能有空格或中文（某些系统下会导致解析失败，尤其Windows + WSL混合场景）
composer require加--repository-url时路径要写全，且必须可访问
用命令行快速引入本地包时，--repository-url参数传入的是临时仓库地址，它不会自动补全相对路径逻辑——你给什么，Composer 就查什么。
比如当前在/project/app，想引用/project/lib，不能写：
composer require acme/lib --repository-url="./lib"
而必须写：
composer require acme/lib --repository-url="/project/lib"
或者更稳妥地用$(pwd)展开（Linux/macOS）：
composer require acme/lib --repository-url="$(pwd)/../lib"
- 路径必须真实存在且有读权限，否则报
Repository could not be processed - 该方式生成的
repositories条目会直接写进composer.json，url值就是你传的原始字符串，不会自动转为相对路径 - CI/CD 中慎用此方式，因为硬编码绝对路径会导致构建失败
path依赖默认启用symlink，但Windows需确认COMPOSER_HOME权限
Composer对path类型仓库默认使用符号链接（symlink），而非复制文件。这带来两个关键影响：
- 修改
../my-shared-lib源码后，无需composer update即可在主项目中生效（适合快速迭代） - Windows上若未以管理员身份运行终端，或
COMPOSER_HOME所在磁盘未启用开发者模式，mklink会失败，回退为copy，此时修改源码不会实时反映 - 可通过
"options": {"symlink": false}强制关闭链接（不推荐，失去热更新优势）
验证是否成功软链：检查vendor/acme/my-shared-lib是否为快捷方式（Windows）或ls -l显示->（Linux/macOS）。
path依赖的版本约束实际无效，*和dev-main效果一样
Composer对path仓库不校验version字段，也不按语义化版本解析分支或tag。它只认composer.json里声明的"name"，然后无条件加载该目录下的代码。
这意味着：
-
"require": {"acme/lib": "1.2.0"}和"acme/lib": "*"行为完全一致 - 即使目标库
composer.json里写"version": "9.9.9"，也不会触发版本冲突；写"version": "dev-legacy"也照样能装 - 唯一真正起作用的版本标识是
"branch-alias"（仅当配合composer update切换不同path目标时有用）
所以别花时间纠结path依赖的版本号写法——只要name匹配、路径可达、composer.json合法，就一定能装进去。
最容易被忽略的一点：当你把一个path依赖提交到 Git 后，其他协作者composer install时，如果他们的目录结构和你不同（比如../my-shared-lib不存在），就会直接失败。这时必须靠文档或Makefile统一约定路径，或改用git仓库+dev-master替代path。
