企业官网建设流程全解析

first-contributions 中的 Git 文件移除指南：用 git rm --cached 停止跟踪但保留本地文件

【免费下载链接】first-contributions🚀✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions

导读

在参与开源项目（例如通过 first-contributions 仓库完成你的第一次贡献）的过程中，你常常会遇到一种需求：让 Git 停止跟踪某个文件，但又不希望它从你的电脑上消失。本指南以 removing-a-file.pt_br.md 为核心，结合仓库内配套的进阶文档，系统讲解git rm --cached的用法、背后的工作原理，以及与.gitignore配合的最佳实践。读完本文，你将掌握"只解除跟踪、不删除本地文件"的完整操作流程，并能将其应用到日常的版本管理与开源贡献场景中。

为什么需要"从 Git 移除文件"而不删除本地文件

在 Git 的默认行为中，一个文件一旦被git add加入暂存区并git commit提交，就会进入版本库的跟踪范围。此后对它的任何修改都会体现在git status中。

但在实际开发中存在大量"不该被跟踪"却已经被跟踪的文件：

• 本地生成的环境变量配置（如.env）；
• 编译产物、日志、缓存文件；
• 个人专属的 IDE 配置或临时文件；
• 误提交的大文件或密钥文件。

如果直接用git rm <file>删除，文件会同时从磁盘上消失，这往往不是我们想要的。first-contributions 仓库的进阶文档 creating-a-gitignore-file.md 明确指出：对于"已经提交过、之后才加入.gitignore"的文件，必须先把它从 Git 跟踪中移除。这正是git rm --cached的核心使用场景。

核心命令：git rm --cached

在仓库根目录或文件所在目录执行以下命令，即可将文件从 Git 的跟踪列表中移除，同时保留它在本地文件系统中的实体：

git rm <file> --cached

以 first-contributions 入门流程中的典型场景为例，假设你误把file1.js提交到了仓库，现在想停止跟踪它：

git rm file1.js --cached

命令执行后，Git 会输出类似rm 'file1.js'的提示，但请注意：这里的rm只作用于 Git 的索引（index/暂存区），并不会真正删除你磁盘上的file1.js。原文档 removing-a-file.pt_br.md 的核心示例即为此命令，英文原文可见 removing-a-file.md。

提示：git rm的完整语法是git rm [<options>] [--] <file>...，--cached是其常用选项之一，含义为"仅从索引中移除，不触碰工作区文件"。

命令执行后发生了什么

执行git rm <file> --cached后，Git 会发生两件事：

1. 停止跟踪：该文件从 Git 的索引（暂存区）中被移除。对 Git 来说，这条改动等价于"删除了这个文件"——下一次提交时，Git 会记录该文件从版本库中消失。
2. 保留本地文件：工作区中的文件实体原封不动。如果你去文件系统中查找，会发现文件仍然存在，内容也未被修改。

你可以用git status验证结果。此时 Git 会同时报告两类信息：

• 一个deleted状态（针对已暂存的移除操作，即git rm --cached产生的暂存改动）；
• 一个untracked状态（因为本地文件还在，但已不在跟踪范围内，所以被识别为"未跟踪文件"）。

这正是"从 Git 的角度看像是删除了，从文件系统的角度看文件还在"的直观体现。

关键区别：不加 --cached 会怎样

--cached标志是整个操作的分水岭。原文档特别强调：

如果省略--cached，Git 不仅会从仓库中移除文件，还会从你的文件系统中删除它。

两者对比如下：

因此，凡是"文件还要继续用、只是不想让 Git 管它"的场景，都必须带上--cached。一旦误用了不带标志的git rm，本地文件会被直接删除，只能依靠git checkout -- <file>或git restore <file>从最近一次提交中恢复。

提交并推送到远程仓库

git rm --cached只是把"移除跟踪"这一改动写入了暂存区，要让它生效并同步到远程，还需要完成提交与推送：

git commit -m "Remove file1.js" git push origin master

其中：

• git commit -m "Remove file1.js"将"停止跟踪 file1.js"固化为一次提交；
• git push origin master把该提交推送到远程仓库。推送后，远程仓库同样会移除该文件的跟踪。

需要注意的是，first-contributions 主流程文档 README.md 推荐的默认分支以及git push用法可能因项目而异。原文档（removing-a-file.md）同时指出，应推送到你正在工作的分支。在 first-contributions 的入门教程中，贡献者通常先git switch -c your-new-branch-name创建分支，再git push -u origin your-branch-name推送，你可以参照 README 中的对应步骤选择正确的分支名与远程名。

附加功能：一次移除多个文件

同时移除多个文件

如果你需要停止跟踪多个文件，可以把它们全部写在同一条命令中：

git rm file1.js file2.js file3.js --cached

这条命令会一次性把file1.js、file2.js、file3.js全部从 Git 跟踪中移除，本地文件均保留。

使用通配符批量移除

你还可以使用通配符（*）批量移除所有相似文件。例如，希望把本地仓库中所有.txt文件停止跟踪：

git rm *.txt --cached

这条命令会匹配当前目录下所有.txt文件并解除其跟踪。结合前文提到的索引概念，通配符由 Git 在索引中展开匹配，因此只作用于已被跟踪的.txt文件，不影响本地文件。

需要留意的是：通配符的匹配范围与 shell 和路径有关。若文件分散在不同子目录，可能需要配合递归选项（如git rm -r --cached）或显式指定路径；first-contributions 的.gitignore文档 creating-a-gitignore-file.md 中提供了"一次性解除所有已忽略文件跟踪"的批量方案：

git rm -r --cached . git add . git commit -m "Updated .gitignore"

与 .gitignore 配合：停止跟踪后防止再次被跟踪

git rm --cached通常与.gitignore配合使用，形成完整的"停止跟踪"闭环：

1. 在.gitignore中写入想要忽略的文件模式（如*.txt、.env、node_modules/）；
2. 对已经提交过的文件执行git rm --cached <file>，解除既有跟踪；
3. 提交并推送，此后该文件既不在版本库中，也不会再出现在git status里。

first-contributions 的进阶文档 creating-a-gitignore-file.md 给出了.gitignore的基础语法：*表示通配符、/表示相对于.gitignore的路径、#表示注释。例如：

# Ignore log and cache files *.log .cache/ # Ignore environment files .env # Ignore all text files *.txt

需要强调的是：.gitignore只对"尚未被跟踪"的文件生效，对已经提交过的文件无效——这正是必须先执行git rm --cached的原因。两者的配合逻辑在仓库文档中构成了完整的进阶知识链，可参见 additional-material.md 中的索引说明。

撤销误操作

如果执行git rm --cached后反悔了，想恢复对文件的跟踪，最简单的方式是重新把它加回暂存区：

git add <file>

执行后文件会重新进入跟踪状态。不过请记住，恢复跟踪并不会撤销"移除跟踪"的那次提交——如果你已经提交并推送了移除操作，需要结合提交回滚（如git revert）来恢复远程状态，相关流程可参考仓库中的 reverting-a-commit.md 与 undoing-a-commit.md。

小结

git rm --cached是 Git 中"解除跟踪但不删除文件"的标准工具，也是将已提交文件纳入.gitignore管控前的必经步骤。回顾本文核心要点：

• git rm <file> --cached：停止跟踪，保留本地文件；
• 省略--cached：文件同时从磁盘删除；
• 配合git commit与git push：让远程仓库同步移除跟踪；
• 支持多文件与通配符批量操作；
• 与.gitignore配合，可彻底避免文件被再次跟踪。

在 first-contributions 的贡献流程中，无论你是初次提交Contributors.md的修改，还是后续维护 fork 时整理文件跟踪状态，掌握这一命令都能让你更从容地控制仓库的"内容边界"。仓库中的完整进阶材料索引见 additional-material.md，其中还包含分支管理、合并冲突解决、提交压缩等更多实战主题，值得继续深入阅读。

【免费下载链接】first-contributions🚀✨ Help beginners to contribute to open source projects项目地址: https://gitcode.com/gh_mirrors/fi/first-contributions