composer path仓库生效需同时满足：type为"path"、url是本地绝对路径（无~、无./、无尾部/）、路径下有合法composer.json；否则静默忽略。
composer config repositories.path 为什么总配不生效
它不是命令写错了，而是 path 类型仓库有三个硬性前提：必须用 type: "path"（不能是 "package" 或漏写），url 必须是**本地绝对路径**（相对路径、~/、. 全部被忽略），且该路径下必须存在合法的 composer.json 文件——少一个条件，Composer 就静默跳过，连 warning 都不抛。
常见错误现象：
-
composer install报Could not find package vendor/name，但ls /your/path/to/pkg确实存在 - 执行
composer config repositories输出里根本看不到你刚加的 path 条目 - 路径含空格或中文，命令看似成功，实际写入配置时被截断
实操建议：
- 用
realpath转成绝对路径：composer config repositories.mypkg path "$(realpath ./local-pkg)" - 路径末尾**不能加
/**（和composer类型相反）：/home/user/pkg✅，/home/user/pkg/❌ - 验证方式：直接运行
cat ~/.composer/config.json | grep -A2 mypkg，确认输出含"type": "path", "url": "/abs/path/to/pkg"
path 仓库如何让 symlink 项目实时生效
默认情况下，Composer 会把 path 仓库内容拷贝进 vendor，改源码不触发自动重装——这不是 bug，是设计行为。要让它像软链一样实时同步，必须显式启用 symlink 模式。
关键点：
- 只对
type: "path"有效，vcs或composer类型不支持 - 必须在添加仓库时就带上
options字段，后续无法用config命令补加 - 启用后，
vendor/vendor/name将是到源路径的符号链接，而非副本
正确写法示例（项目级）：
composer config repositories.mypkg '{"type":"path","url":"/abs/path/to/pkg","options":{"symlink":true}}'
注意：options 必须是完整 JSON 字符串，单引号包裹，双引号在内部不能省；若路径含特殊字符，先用 printf %q 转义。
path 仓库和 require-dev 的协作陷阱
当 path 仓库包只出现在 require-dev 里，而你执行的是 composer install --no-dev，它会被完全忽略——即使配置已存在，也不会报错或提示。
更隐蔽的问题是版本约束冲突：
-
path包的composer.json里写了"version": "dev-main"，但主项目require-dev写的是"vendor/name": "^1.0"，Composer 会拒绝匹配（dev-main不满足^1.0） - 解决方法只有两个：删掉
path包里的version字段（让 Composer 自动推导），或把require-dev改成"dev-main as 1.0.0"
另一个坑：path 包自身若有 require-dev，它的开发依赖**不会被安装**——Composer 只解析顶层项目的 require-dev，path 包的 dev 依赖被当作“不可见”处理。
CI 环境下 path 仓库的路径权限问题
Docker 或 CI runner 中，path 仓库路径常因挂载方式或用户 UID 不一致导致失效。典型表现是 composer install 卡住、无报错，或提示 Could not scan for classes。
根本原因不是路径不存在，而是 PHP 进程没权限读取该路径下的 composer.json 或文件系统元数据。
排查与修复步骤：
- 进容器执行
ls -ld /abs/path/to/pkg，确认 owner 和 group 对应当前运行用户（如www-data） - 检查挂载参数：Docker 中避免用
:ro，Mac 上用docker run --mount type=bind,source=$(pwd)/local-pkg,target=/app/pkg,consistency=cached - 最稳妥方案：不在 CI 中用
path，改用composer config repositories.mypriv composer https://my-internal-repo.com/+auth.json认证
最后提醒：path 仓库永远只在本地开发有意义，切勿提交到 git 的 composer.json 中——它天然不具备可移植性，队友拉代码后路径必炸。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
