返回知识库

版本协作 · 版本协作

忽略文件.gitignore

对照未跟踪与已跟踪日志,观察忽略规则与停止跟踪分别改变了什么。

给两个日志加同一条规则,查看谁仍被跟踪

debug.log 是新文件,activity.log 已经进过历史。规则相同,Git 的处理仍可能不同。

第 0 步:先打开项目根目录 .gitignore,再在同一目录运行 git status。下面是模拟文件,不会删除你的日志。

.gitignore
# 还没有忽略日志的规则

本机文件 · 始终保留

📄 debug.log 从未提交

📄 activity.log 历史已跟踪

磁盘上仍有 2 个文件

git status · 待处理

  • ?? debug.log · 未跟踪
  • M activity.log · 已跟踪,有新修改

下一步:先观察两个文件状态,再添加规则比较。

知识点:忽略与停止跟踪是两件事

.gitignore 的模式用于指定有意不跟踪的文件。已经被 Git 跟踪的文件不会因匹配规则而停止跟踪,所以 activity.log 的 M 仍然存在。

git rm --cached 仅从索引移除,工作区文件保留;删除变化仍须提交才能进入下一份快照。它不抹除旧历史,也不撤回别人已拿到的内容。

什么时候用、怎么用

  1. 缓存、日志、构建产物不该纳入协作时,先添加精确规则,避免误伤需要提交的文件。
  2. 用 git status 和 git check-ignore -v 检查未跟踪文件;已跟踪的再用 git ls-files 核实。
  3. 确定要退出跟踪时,执行 git rm --cached -- 文件路径,核对磁盘文件保留与暂存删除,再连同规则提交。

秘密已经提交时,忽略规则不能修复泄漏;应撤销/轮换凭据,再按仓库流程处理历史。命令范围要先确认,勿把 --cached 漏掉。

正反例:同一条 *.log,只差跟踪状态

正例:debug.log 从未跟踪,规则生效后不再进入普通待提交列表。

反例:activity.log 已经跟踪,只加规则仍显示 M;核对用途后停止跟踪并提交,才能让新快照不再包含它。

快速自测

git rm --cached 移除了日志的索引记录,但磁盘上文件还在,是否失败?

继续查证

术语的技术定义和行为以这些一手或权威资料为准。

下一步学