如何忽略已经被 Git 跟踪的文件?

将路径加入 .gitignore 不会改变 Git 索引中已有的文件。需要将路径从索引移除,并仔细检查待提交的改动。

确认文件已被跟踪

检查 Git 是否已经跟踪该路径:

git ls-files -- path/to/file

如果命令输出路径,说明文件已被跟踪。先在项目 .gitignore 中添加合适规则,再只移除索引中的副本:

git rm --cached -- path/to/file

--cached 会保留本地工作副本。提交前检查 git status 和暂存区差异。协作者拉取这个提交时,文件可能从其工作区中移除,必要时提前协调。

处理目录

先检查目录中具体有哪些已跟踪路径,再使用递归移除命令:

git ls-files -- path/to/directory
git rm -r --cached -- path/to/directory

如果曾经提交过密钥

从最新版本中移除密钥不会清除旧历史。请轮换已泄露的凭据,并按照托管平台的事件处理指引操作。后续添加 .gitignore 规则只能帮助避免再次误提交。

准确行为与更多细节请参阅官方说明: GitHub 忽略文件指南