答案是必须用相对于主项目composer.json的路径,且被引用包自身composer.json需声明"options": {"symlink": true};否则跨机器失效、软链不生效。

path仓库必须用相对路径,否则在别人机器上直接失效
你在本地写 "url": "/home/alex/mylib" 或 "url": "../mylib",别人 clone 项目后 composer install 会静默跳过这个仓库——Composer 根本不报错,只是当它不存在。根本原因是 repositories.type: "path" 只接受相对于项目根目录的路径,且不允许跨出项目边界。
✅ 正确做法是统一约定包目录结构,比如:
- 主项目根目录下建
packages/my-utils - 在主项目
composer.json的repositories里写"url": "packages/my-utils" -
url值不能以./开头,也不能含环境变量(${HOME}、$_ENV全无效)
软链接不是配在主项目,而是在被引用包自己的 composer.json 里
很多人在主项目的 repositories 中加 "options": {"symlink": true},结果毫无作用。path 类型仓库的 symlink 行为完全由被引用包控制——也就是 packages/my-utils/composer.json 必须包含:
{
"name": "acme/utils",
"version": "1.0.x-dev",
"options": {
"symlink": true
}
}
⚠️ 注意:composer install 不重建软链,只有 composer update acme/utils 或全量 update 才触发;CI 环境通常禁 symlink,此时要确保包本身可独立运行测试,别依赖“边改边调”。
require 版本号必须和被引用包的 name + version 完全匹配
如果 packages/my-utils/composer.json 写着 "name": "acme/utils" 但漏了 version 字段,Composer 2.5+ 会直接拒绝加载;如果写了 "version": "dev-main",而主项目 require 里写的是 "acme/utils": "^1.0",就会报 Could not find package acme/utils。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
稳住的写法是:
- 被引用包固定用
"version": "1.0.x-dev" - 主项目对应写
"acme/utils": "1.0.x-dev" - 绝对不要省略
version字段,也别用dev-master这类模糊值(语义不清,CI 易失败)
团队必须提交 composer.lock,且 vendor/ 永远不进 Git
有人觉得 “path 包是本地的,lock 文件无所谓”,这是最危险的认知偏差。没有 composer.lock,不同人执行 composer install 时,Composer 会重新解析依赖树——哪怕所有包都是 path 类型,也可能因 autoload 配置差异、PHP 版本微小变动或扩展缺失导致自动加载失败。
关键动作只有两个:
- 所有成员每次修改本地包或主项目依赖后,都运行
composer update并提交更新后的composer.lock -
vendor/目录加到.gitignore,永远不 commit —— 它是构建产物,不是源码
真正容易被忽略的是:path 仓库的稳定性不来自“本地”这个事实,而来自 lock 文件对整个依赖图的精确固化。一旦跳过这步,协作就退化成靠运气同步。










