版本控制与协作 / 系统课时
处理已经被跟踪的忽略文件
处理已经被跟踪的忽略文件
学习目标
完成本课后,你将能够:
- 解释忽略规则不影响已跟踪文件
- 使用 rm --cached 停止跟踪并保留本地文件
- 提交规则与索引变化完成团队同步
问题背景或应用场景
把文件写入 .gitignore 后,Git 仍继续显示其修改,最常见原因是该文件已经被提交。忽略规则只决定未跟踪路径是否出现,不能自动修改索引。
核心原理
git rm --cached <文件> 从索引删除路径,但保留工作区文件。提交后,其他成员拉取该提交时,受跟踪版本会从其工作区删除;他们需要根据项目说明重新创建本地配置。因此通常应同时提供不含密钥的模板文件。
对整个目录重新应用忽略规则时,可先从索引移除再重新添加,但操作范围大,应审查暂存差异,避免无意删除必要文件。
基础用法
先把路径加入 .gitignore,再执行 git rm --cached <文件>。检查 git status,确认表现为删除受跟踪文件和新增忽略规则,同时本地文件仍存在。提交后用 git ls-files 验证不再跟踪。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。
bash
rm -rf git-untrack-demo
mkdir git-untrack-demo
cd git-untrack-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "local=true
" > config.local
git add config.local
git commit -q -m "chore: add local config"
printf "config.local
" > .gitignore
git rm -q --cached config.local
git add .gitignore
git commit -q -m "chore: stop tracking local config"
printf "file-kept: "
if test -f config.local; then echo yes; else echo no; fi
printf "tracked-count: "
git ls-files config.local | wc -l | tr -d ' '
printf "ignored: "
git check-ignore config.local预期输出
text
file-kept: yes
tracked-count: 0
ignored: config.localTips
- 本地配置应提供
config.example模板。 - 提交前确认
rm --cached没有误作用于目录。 - 含密钥文件还需轮换凭据,而不只是停止跟踪。
常见错误
1. 使用 git rm 未加 cached
- 错误表现:本地文件也被删除。
- 产生原因:执行了工作区与索引同时删除。
- 正确处理:需要保留本地文件时使用
--cached,必要时从备份恢复。 - 修复结果:索引停止跟踪而本地文件存在。
2. 只改 .gitignore
- 错误表现:文件修改仍持续出现在状态中。
- 产生原因:路径已被索引跟踪。
- 正确处理:执行
git rm --cached并提交。 - 修复结果:后续本地修改被忽略。
本课练习
1. 停止跟踪本地配置
- 任务目标:练习标准流程。
- 输入或初始条件:
application-local.yml已提交。 - 实现要求:忽略并从索引移除。
- 验收条件:文件本地保留且
ls-files无结果。
2. 提供配置模板
- 任务目标:改善团队体验。
- 输入或初始条件:真实配置被停止跟踪。
- 实现要求:创建无密钥模板并提交。
- 验收条件:新成员可以复制模板完成配置。
3. 批量重建索引
- 任务目标:理解高风险方案。
- 输入或初始条件:仓库新增多条忽略规则。
- 实现要求:在实验分支重新应用规则并审查差异。
- 验收条件:必要源码没有被误删除。
按自己的节奏,确认真正理解。