唯一可靠方案是path仓库:主项目repositories需配相对路径url,被引用包composer.json必须声明"options":{"symlink":true}且name/version与require严格匹配,必须提交composer.lock并验证软链生效。

直接共享临时文件给同事,composer 本身不支持——它没有“临时包上传”或“本地文件直传”机制。所谓“共享临时文件”,实际场景通常是指:你改了一个本地包(比如 packages/my-utils),想让同事立刻用上你的修改,而不是等发版、推 Git、走 Packagist 流程。
path 仓库是唯一能落地的方案
别试 composer link、别打包 zip 发微信、别手动生成 dist、也别指望 composer install --no-cache 能绕过锁定——这些在团队协作中都会失效或引发不一致。
-
composer link只作用于已安装包,不写composer.lock,CI 构建时根本找不到目标 - 发 zip 给同事手动解压到
vendor/?路径、autoload、版本校验全靠人肉对齐,一次composer update就被覆盖 -
path是 Composer 唯一原生支持的“本地开发态共享”方式,但必须满足四个硬性条件
四个必须同时满足的条件
缺一个,同事 composer install 后就报 Could not find package 或 vendor 下是副本而非软链。
-
主项目
composer.json的repositories中,url必须是相对于项目根目录的路径,例如"url": "packages/my-utils";禁止"../my-utils"(跨项目边界)、"./packages/my-utils"(./前缀无效)、"${HOME}/xxx"(环境变量不展开) -
被引用包(即
packages/my-utils/composer.json)必须声明"options": {"symlink": true};主项目里配"options"对path类型完全无效 -
被引用包的
name和version必须与主项目require字段逐字匹配,包括大小写、斜杠、vendor 名;version不能为空(Composer 2.5+ 拒绝加载) -
必须提交
composer.lock,且禁止提交vendor/;否则同事拉代码后依赖树无法复现,path会被静默跳过,转而从 Packagist 尝试下载
验证软链是否生效
运行 composer update vendor/name(不是 install)后,立即检查结果:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- Linux/macOS:
ls -la vendor/vendor/name应显示-> packages/my-utils这样的符号链接 - Windows:
dir vendor\vendor\name应显示“快捷方式”类型(需开启开发者模式或管理员权限运行终端,否则 symlink 会静默退化为复制) - 改
packages/my-utils里的代码,刷新主项目页面或跑测试,应立刻生效——这是热更新的唯一可靠信号
容易被忽略的 CI 和 Windows 陷阱
很多团队在本地跑通了,一上 CI 就失败,或者 Windows 同事始终看不到软链。核心原因就两个:
- CI 环境(如 GitHub Actions、GitLab CI)默认禁用 symlink,Docker 容器挂载限制也常导致
symlink: true失效;此时应确保被引用包自身可独立运行(有完整 autoload、含测试用例),避免依赖“实时编辑” - Windows 用户未启用“开发者模式”,或未以管理员身份运行终端,
composer update会悄悄复制文件而非创建软链,且不报错——必须主动验证dir输出
真正难的不是配置,而是让所有人理解:path 共享不是“临时传个文件”,而是一套需要双方严格对齐的契约。路径、name、version、symlink 权限、lock 文件,五者缺一不可。










