如何拉取上游仓库代码，避免Git误识别重命名文件冲突？

核心原因 #

Git通过文件的历史关联和内容特征识别文件关系，你手动重命名文件时，Git会将操作识别为「删除原文件+添加新文件」，而非官方的重命名记录。当上游修改原文件后，合并时Git会认为你删除原文件的操作与上游修改操作冲突，进而将你的新文件与上游原文件误判为需要合并的同一文件。

方法一：手动检出上游原文件，保留个人文件 #

如果已经遇到冲突，按以下步骤操作：

1. 取消当前失败的合并：

   git merge --abort
   

2. 从上游仓库直接检出最新的Notebook_00.ipynb文件到本地：

   # 替换main为上游仓库的默认分支名（如master）
   git checkout upstream/main -- "Directory A/Notebook_00.ipynb"
   

3. 此时本地会同时存在上游的Notebook_00.ipynb和你的Notebook_00_Personal.ipynb，提交变更：

   git add .
   git commit -m "同步上游Notebook_00.ipynb，保留个人修改版本"
   

方法二：用git mv记录重命名，避免后续冲突 #

如果是后续要创建个人版本，用Git官方的重命名命令让Git明确识别文件关系：

1. 先同步上游最新代码到本地：

   git fetch upstream
   git merge upstream/main
   

2. 用git mv重命名或移动文件（比如移到新目录）：

   # 重命名到原目录
   git mv "Directory A/Notebook_00.ipynb" "Directory A/Notebook_00_Personal.ipynb"
   # 或者移到新子目录
   mkdir -p "Directory A/Personal"
   git mv "Directory A/Notebook_00.ipynb" "Directory A/Personal/Notebook_00_Personal.ipynb"
   

3. 提交重命名操作：

   git commit -m "将Notebook_00.ipynb重命名为个人版本"
   

4. 之后修改个人版本并提交即可，后续同步上游时，Git会正确识别重命名记录，不会将个人文件与上游原文件视为同一文件冲突。

方法三：通过.gitattributes指定文件合并策略（可选） #

如果需要长期避免这类冲突，可以在仓库根目录创建.gitattributes文件，指定上游原文件的合并策略为优先保留上游版本：

1. 创建.gitattributes文件并添加内容：

   Directory A/Notebook_00.ipynb merge=theirs
   

   该规则表示合并时，Notebook_00.ipynb直接采用上游（theirs）的版本，忽略本地对该文件的删除/修改操作。
2. 提交.gitattributes文件：

   git add .gitattributes
   git commit -m "设置Notebook_00.ipynb合并策略为优先上游版本"
   

   之后同步上游时，Git会自动应用该策略，无需手动处理冲突。

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