refusing to merge unrelated history

### 解决 Git 合并不相关历史记录的问题

当遇到 `fatal: refusing to merge unrelated histories` 错误时，这通常发生在尝试将两个独立创建的仓库合并在一起的情况下。自 Git 2.9 版本起，默认情况下不允许这种操作以防止意外的数据丢失或混淆。

#### 方法一：允许合并不相关的提交历史

可以通过设置参数来覆盖默认行为并强制允许合并不同的历史：

git pull origin master --allow-unrelated-histories

这条命令会告诉 Git 即使是不相关的项目也可以被合并[^1]。

#### 方法二：通过变基方式处理

另一种方法是使用 rebase 来代替直接的 merge 或者 pull 操作。先获取最新的远程更改而不立即将其应用到当前分支上；接着切换回工作分支并将这些更新重新应用于该分支之上。

# 获取最新变更但暂不做任何改动
git fetch upstream
# 切换至目标分支
git checkout your_branch_name
# 将上游修改rebase到本地分支中
git rebase upstream/master

如果希望保留原始提交信息，则可以考虑采用交互式的变基过程(`git rebase -i`)来进行更精细的操作[^2]。

#### 方法三：克隆新库再推送现有文件

对于某些场景来说，最简单的方法可能是完全放弃旧有的本地副本，转而从头开始建立一个新的克隆实例，并把必要的资源复制过去。这样做虽然有些繁琐，但却能彻底规避掉因历史冲突引发的各种麻烦。

# 创建临时目录用于保存重要资料
mkdir temp_folder && cd $_
# 复制需要转移的内容至此处
cp -r /path/to/old/repo/* .
# 进入新的干净环境
cd ..
rm -rf old_repo_directory/
# 克隆官方源码树作为基础框架
git clone https://github.com/user/new-repository.git new_project_dir
mv ./temp_folder/* ./new_project_dir/
cd new_project_dir
# 添加所有变动准备提交
git add .
git commit -m "Initial import from previous project"

以上三种方案可以根据实际情况灵活选用，其中前两种更为常见也相对容易实现一些[^3]。