fork仅作临时补丁,须确认上游是否已合并改动,切回主干时必须删除repositories配置、验证composer.lock中无git source残留,超3个月未合入应改用patches插件而非长期维护fork。

先确认 fork 是否还必要
别急着切回主干或保留 fork,先查清楚你 fork 的改动有没有被上游合并。运行 git log --oneline --cherry-pick origin/main...your-fork/main 看有没有未合入的 commit;或者直接打开原始包的 GitHub Releases 页面,找最近几个 tag 的 CHANGELOG,核对你的修复是否已包含在 v1.3.0 或更高版本里。如果已有,就别维护 fork 了——它只会拖慢 CI、增加安全审计负担。
切回主干时必须删掉 repositories 配置
很多人改完 require 字段就跑 composer update,结果 vendor/ 里还是旧 fork 的代码。根本原因是 repositories 里还留着 fork 的 Git 地址,Composer 优先从那里拉包。必须手动删掉 composer.json 中类似这样的块:
{
"type": "git",
"url": "https://github.com/yourname/package-fork"
}
删完再执行 composer update vendor/original-package,否则 Composer 会继续走 fork 源,哪怕 require 已指向官方包名。
线上部署前务必验证 composer.lock 是否干净
composer.lock 会固化依赖来源,但 fork 切换后容易残留旧路径。检查方法很简单:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 运行
composer show vendor/original-package,看输出的 source 是dist还是source - 打开
composer.lock,搜索该包名,确认"source": {"type": "git", ...}已消失,只剩"dist"字段 - CI 流水线里加一行
grep -q '"type":"git"' composer.lock && exit 1 || echo "OK",防住误提交
漏掉这步,上线后可能跑着 fork 代码却以为已在用主干,出问题连回滚点都难定位。
别让 fork 成为长期技术债
fork 的唯一合理生命周期是:临时补丁 → 提 PR 给上游 → 等发布 → 切回主干 → 删除 fork 仓库。如果 fork 存活超过 3 个月,大概率说明你没推动合入,或上游响应太慢。此时更稳妥的做法不是继续维护 fork,而是用 cweagans/composer-patches 插件打最小化 patch,并在 composer.json 里写明 "TODO: remove after vendor/package v1.4.0"。这样既可控,又不会把整个包源锁定在不可审计的私有 Git 上。










