Git 忽略已被跟踪文件的本地修改

方法 1：使用 TortoiseGit 界面操作#

如果你习惯使用图形化界面：

1. 在文件上 右键 -> TortoiseGit -> 設定 (Settings)。
2. 进入 コンテキストメニュー (Context Menu) 选项卡。
3. 勾选 変化していないものとみなす (Assume unchanged)。
4. 回到文件右键，即可看到该选项。点击后，文件图标的红色感叹号将消失。

方法 2：使用自动化脚本（推荐）#

对于需要批量处理多个文件或子目录的情况，使用批处理脚本（.bat）效率更高。

1
@echo off
2
rem 项目根目录路径切换
3
cd /d "C:\Your\Project\Path"
4

5
echo 正在处理指定文件列表...
6

7
rem 批量忽略特定后缀的文件（递归子文件夹）
8
for /f "delims=" %%i in ('git ls-files "path/to/dir/*.xml"') do (
9
    git update-index --assume-unchanged "%%i"
10
)
11

12
rem 忽略特定的单个文件
13
git update-index --assume-unchanged "path/to/your/TargetFile.java"
14

15
echo ==========================================
16
echo 处理完毕！目前处于“隐藏”状态的文件：
17
git ls-files -v | findstr "^h"
18
echo ==========================================
19
pause

1
@echo off
2
cd /d "C:\Your\Project\Path"
3

4
echo 正在恢复所有被隐藏的文件状态...
5

6
for /f "tokens=2" %%i in ('git ls-files -v ^| findstr "^h"') do (
7
    git update-index --no-assume-unchanged "%%i"
8
    echo 已恢复: %%i
9
)
10

11
echo 所有文件已恢复正常。
12
pause

1. 执行了忽略，但 git pull 报错怎么办？#

如果远程仓库更新了同一个文件，Git 会为了保护你的本地修改而终止 Pull。此时请先运行 GitShow.bat，执行 git stash 暂存修改，然后再 Pull，最后恢复状态。

2. 为什么 .gitignore 不起作用？#

.gitignore 只能忽略**未被跟踪（Untracked）**的文件。一旦文件曾经被 git add 过，就必须使用本文提到的 update-index 方法。

安全提醒：本文档仅限内部技术交流，请勿将包含具体业务路径的脚本上传至公共仓库。