版本控制与协作 / 系统课时

处理已经被跟踪的忽略文件

处理已经被跟踪的忽略文件

学习目标

完成本课后,你将能够:

  • 解释忽略规则不影响已跟踪文件
  • 使用 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.local

Tips

  • 本地配置应提供 config.example 模板。
  • 提交前确认 rm --cached 没有误作用于目录。
  • 含密钥文件还需轮换凭据,而不只是停止跟踪。

常见错误

1. 使用 git rm 未加 cached

  • 错误表现:本地文件也被删除。
  • 产生原因:执行了工作区与索引同时删除。
  • 正确处理:需要保留本地文件时使用 --cached,必要时从备份恢复。
  • 修复结果:索引停止跟踪而本地文件存在。

2. 只改 .gitignore

  • 错误表现:文件修改仍持续出现在状态中。
  • 产生原因:路径已被索引跟踪。
  • 正确处理:执行 git rm --cached 并提交。
  • 修复结果:后续本地修改被忽略。

本课练习

1. 停止跟踪本地配置

  • 任务目标:练习标准流程。
  • 输入或初始条件:application-local.yml 已提交。
  • 实现要求:忽略并从索引移除。
  • 验收条件:文件本地保留且 ls-files 无结果。

2. 提供配置模板

  • 任务目标:改善团队体验。
  • 输入或初始条件:真实配置被停止跟踪。
  • 实现要求:创建无密钥模板并提交。
  • 验收条件:新成员可以复制模板完成配置。

3. 批量重建索引

  • 任务目标:理解高风险方案。
  • 输入或初始条件:仓库新增多条忽略规则。
  • 实现要求:在实验分支重新应用规则并审查差异。
  • 验收条件:必要源码没有被误删除。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理已经被跟踪的忽略文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通