---
date: 2026-1-10 14:54:51
updated: 2026-1-10 14:54:51
title: Git创建远程仓库推送出现refusing to merge unrelated histories问题处理
---

# 背景

在本地创建了项目并使用git进行跟踪，在远程仓库创建了项目，并进行了一些初始化，例如生成了README.md Linces等文件的时候，关联远程仓库并推送的时候会出现下面的报错：
```
* branch master -> FETCH_HEAD = [up to date] master -> origin/master fatal: refusing to merge unrelated histories
```

# 核心报错原因

该错误是 Git 的**安全机制拦截**：本地仓库和远程 `origin/master` 分支被判定为 **两个完全独立、无血缘关系** 的仓库（无共同的初始提交），Git 默认拒绝合并这类「无关历史」，避免仓库数据混乱。

> ✅ 你的场景补充：`up to date` 仅代表分支提交记录数量一致，不代表历史同源，核心矛盾是「历史无关」而非「版本不一致」。

## 方案 1：【最优推荐】强制合并无关历史（一行命令解决，99% 场景适用）

这是 Git 官方提供的**专属解决方案**，直接添加参数允许合并无血缘关系的仓库，保留双方所有提交记录，是最便捷、最常用的方法：

###  核心命令（直接执行，一步到位）

```bash
# 方式1：拉取远程master并强制合并无关历史（推荐，最常用）
git pull origin master --allow-unrelated-histories

# 方式2：若执行merge操作时报错，用此命令
git merge origin/master --allow-unrelated-histories
```

### 执行后处理（2 种情况）

1. ✅ **无冲突自动合并**：命令执行后直接提示 `Merge made by the 'ort' strategy`，合并完成，本地仓库与远程同源；
2. ⚠️ **出现代码冲突**：Git 会自动进入合并冲突编辑界面，按提示解决冲突即可（下文附极简冲突解决步骤）。

## 方案 2：【兜底方案】本地仓库重置，完全同步远程（无冲突，干净利落）

适合**本地仓库无重要未提交代码**的场景，直接丢弃本地所有历史，将远程 `master` 分支完整覆盖到本地，彻底解决「历史无关」问题，全程无冲突：
```bash
# 1. 暂存本地所有修改（防止文件丢失，可选）
git add .
git commit -m "temp: 暂存本地修改"

# 2. 重置本地master分支，指向远程最新版本（核心）
git reset --hard origin/master

# 3. 拉取远程最新代码，完成同步
git pull origin master
```

> ✅ 优势：零冲突、操作简单，适合本地仓库刚初始化、无核心代码的场景；
> ⚠️ 注意：`--hard` 会**覆盖本地所有未提交 / 已提交的修改**，执行前务必确认本地无重要代码！

---

# 总结

## 场景 1（保留本地代码）→ 用方案 1

```bash
git pull origin master --allow-unrelated-histories
```

## 场景 2（本地无重要代码）→ 用方案 2

```bash
git reset --hard origin/master && git pull origin master
```

执行对应命令后，即可彻底解决「refusing to merge unrelated histories」报错，实现本地与远程分支正常合并 / 拉取！