git -c diff.mnemonicprefix=false -c core.quotepath=false --no-optional-locks fetch --no-tags

发生问题背景：在sourcetree先用https关联远程仓库，拉取代码提交后，本地代码有调整未提交。再用ssh关联远程拉取代码时失败。

完整错误提示如下：

git -c diff.mnemonicprefix=false -c core.quotepath=false --no-optional-locks fetch --no-tags vue3

git -c diff.mnemonicprefix=false -c core.quotepath=false --no-optional-locks pull vue3 master
From gitee.com:jin-lingying/vue3_admin_template-vae
 * branch            master     -> FETCH_HEAD

fatal: refusing to merge unrelated histories

最终通过寻求DeepSeek帮助解决问题，特此记录，以留后参。

这个错误 fatal: refusing to merge unrelated histories 表示 Git 检测到本地仓库和远程仓库的提交历史完全不相关（没有共同的祖先节点），默认情况下 Git 会拒绝这种合并。

原因：
本地仓库已初始化过提交：本地可能已执行过 git init + git commit，创建了独立的历史记录。

拉取远程新仓库：远程仓库（如 vue3_admin_template-vae）是一个新建的仓库，其初始提交与本地提交无关。

分支无关联：本地分支（如 master）尚未与远程分支建立追踪关系。

解决方案：
方法一：允许合并无关历史（推荐）
在 pull 命令中添加 --allow-unrelated-histories 参数强制合并：

bash
git pull vue3 master --allow-unrelated-histories
适用场景：需要保留本地提交并合并远程内容。

结果：Git 会创建一个新的合并提交，将两个独立历史连接起来。

后续操作：解决可能的冲突后提交即可。

方法二：强制覆盖本地代码（谨慎！）
如果不需要本地提交，直接用远程代码覆盖本地：

bash
git fetch vue3 master        # 获取远程内容
git reset --hard vue3/master # 强制重置本地分支
适用场景：放弃所有本地提交，完全使用远程仓库代码。

警告：本地未提交的更改和所有本地提交将被永久删除！

方法三：克隆新仓库（最彻底）
如果本地仓库无重要内容，直接删除后重新克隆：

bash
cd ..
rm -rf <本地仓库目录>          # 删除旧仓库
git clone <远程仓库URL>        # 重新克隆
适用场景：本地历史混乱或无需保留任何本地修改。

预防措施
首次关联远程仓库时：
使用 git clone 代替 git init + git remote add，避免历史冲突。

检查远程分支关联：
执行 git branch -vv 确认本地分支已追踪远程分支：

bash
git branch --set-upstream-to=vue3/master master
操作流程示例（采用方法一）
bash
# 允许合并无关历史
git pull vue3 master --allow-unrelated-histories

# 解决冲突（如果有）
git add .                # 添加解决后的文件
git commit -m "合并远程历史" # 提交合并结果

# 推送更新（如果需要）
git push vue3 master
注意：合并后务必检查代码完整性，尤其是无关历史合并可能引入意外冲突。

选择最适合你场景的方案即可解决问题。