Git拉取时会覆盖refs/notes引用？Git Notes变更日志同步异常

这个问题我太熟悉了！用git-notes --ref changelog维护变更日志确实是个实用的办法，但这种“漏推一个远程，拉取就被覆盖”的坑我也踩过好几次。核心原因是默认的git fetch会直接把远程的refs/notes/changelog引用硬重置到本地，完全不会像普通分支那样尝试合并内容。给你几个靠谱的解决思路：

1. 修改Fetch规则，让Git自动合并Notes（推荐） #

我们可以给每个远程仓库配置自定义的fetch规则，去掉默认的强制更新标记，让Git在拉取Notes时自动尝试合并，而不是直接覆盖。

比如针对你的github远程，执行以下命令：

# 先确保原有分支的fetch规则保留（如果之前没改过的话）
git config remote.github.fetch "+refs/heads/*:refs/remotes/github/*"
# 添加Notes的fetch规则，去掉前面的加号（加号代表强制更新）
git config --add remote.github.fetch "refs/notes/changelog:refs/notes/changelog"

对另外两个远程仓库重复上面的命令，把github换成对应的远程名就行。

之后再执行git fetch github时，Git会自动尝试合并远程和本地的changelog Notes。如果出现内容冲突，它会提示你用git notes merge changelog来手动处理——对于变更日志场景，推荐用cat_sort_uniq合并策略，自动去重合并内容：

git notes merge -s cat_sort_uniq changelog

2. 手动拉取+合并，避免自动覆盖 #

如果不想修改全局配置，每次拉取特定远程的Notes时，可以绕开默认的fetch行为，先拉到临时引用再手动合并：

# 把远程github的changelog Notes拉到本地临时引用
git fetch github refs/notes/changelog:refs/notes/tmp-changelog
# 用去重合并策略把临时内容合并到本地changelog
git notes merge -s cat_sort_uniq changelog tmp-changelog
# 合并完成后删除临时引用
git update-ref -d refs/notes/tmp-changelog

这个方法更灵活，适合偶尔拉取的场景。

3. 写个自动化脚本，避免漏推漏拉 #

既然要同步三个远程，手动推送很容易漏，不如写个小脚本一键搞定推送：

#!/bin/bash
# 替换成你的三个远程仓库名称
REMOTES=("github" "gitlab" "gitee")

echo "=== 推送Changelog Notes到所有远程 ==="
for remote in "${REMOTES[@]}"
do
    echo "正在推送至 $remote..."
    git push "$remote" refs/notes/changelog
done
echo "=== 推送完成 ==="

把脚本存为push-changelog.sh，给它加执行权限chmod +x push-changelog.sh，之后一键运行就行。拉取也可以写类似的脚本，自动合并每个远程的Notes，彻底避免手动操作的失误。

最后提醒下：如果合并时遇到冲突，Git会进入Notes合并状态，你可以用git notes edit changelog手动编辑冲突内容，或者用git notes merge --abort取消合并操作。

内容的提问来源于stack exchange，提问作者musicmatze