在Git中停止追踪文件并加入忽略的操作方法

更新时间：2025年12月30日 09:51:58 作者：爱宇阳

在使用 Git 管理项目时,我们经常会遇到这样的情况：某个文件我不想再提交了,但又不想删除它,该怎么办？比如：配置文件、日志文件、编译生成的文件夹等,这篇文章将手把手教你如何操作,确保你能轻松掌握这个技能,需要的朋友可以参考下

什么是.gitignore？

.gitignore 是一个特殊文件，用来告诉 Git 哪些文件或文件夹不需要被版本控制。

举个例子：

# 忽略 node_modules 文件夹
node_modules/

# 忽略所有 .log 文件
*.log

# 忽略某个配置文件
config/local.env

一旦你把这些路径写进 .gitignore，Git 就不会再自动追踪它们了。

为什么不能直接加.gitignore就完事了？

很多新手会犯一个错误：

“我把文件加到 .gitignore 了，怎么 Git 还是提交了它？”

这是因为：Git 已经在之前的提交中追踪了这个文件，所以它不会自动停止追踪。你需要手动告诉 Git：“别再管它了！”

正确做法：停止追踪 + 加入.gitignore

第一步：停止追踪文件或文件夹

使用命令：

# 停止追踪单个文件
git rm --cached path/to/your/file

# 停止追踪整个文件夹（递归）
git rm -r --cached path/to/your/folder

注意：--cached 表示只从 Git 的索引中移除，不会删除你本地的文件。

第二步：把文件路径加入.gitignore

编辑项目根目录下的 .gitignore 文件，添加你想忽略的路径：

# 忽略某个文件
path/to/your/file

# 忽略整个文件夹
path/to/your/folder/

如果没有 .gitignore 文件，可以新建一个：

touch .gitignore

第三步：提交更改

git add .gitignore
git commit -m "停止追踪并忽略指定文件"

这样就完成了！Git 不会再提交这些文件了。

常见场景示例

文件/文件夹	是否建议忽略	.gitignore 示例
`node_modules/`	✅ 是	`node_modules/`
`.env` 配置文件	✅ 是	`.env`
编译生成的 `dist/`	✅ 是	`dist/`
`.vscode/` 设置	✅ 是	`.vscode/`
源代码 `.js` 文件	❌ 否	不建议忽略，应纳入版本控制

小贴士

如果你不确定某个文件是否被 Git 追踪，可以用命令查看：

git ls-files | grep your_file_name

如果你想忽略某类文件，比如所有 .log 文件：

*.log

如果你想忽略某个文件夹下的所有内容：

your_folder/*

总结

操作流程如下：

用 git rm --cached 停止追踪文件或文件夹
把路径加入 .gitignore
提交更改

这样就能优雅地管理你的项目文件，避免无用文件污染版本库。

到此这篇关于在Git中停止追踪文件并加入忽略的操作方法的文章就介绍到这了,更多相关Git停止追踪文件并加入忽略内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

IntelliJ IDEA卡死，如何优化内存
这篇文章主要介绍了IntelliJ IDEA卡死，如何优化内存，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-05-05
从Git历史中删除误提交文件并保留本地文件的解决方案
本文介绍了如何在Git项目中删除误提交的文件（如node_modules/.env等）,包括用git rm --cached保留本地文件、更新.gitignore防止再次提交,以及用git filter-repo等工具彻底清除Git历史中的敏感文件,保障项目安全,需要的朋友可以参考下
2025-10-10
git 拉取远程分支到本地的方法步骤
这篇文章主要介绍了git 拉取远程分支到本地的方法步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-07-07
Git Cherry Pick使用及说明
cherry Cherry-pick 是 Git 中的一个强大有用的命令,它允许开发者将特定版本的代码应用到当前分支,而不需要合并整个分支,文章详细介绍了 Cherry-p-ck 命令的基本语法、使用场景和具体示例,包括合并单个提交、修复 bug 和提取特定功能等场景
2026-05-05
Jenkins安装及卸载全过程
文章介绍了在CentOS系统上安装Jenkins的方法,包括下载Jenkins安装包、上传并安装、查看安装位置、修改配置文件、启动Jenkins、配置JDK路径、卸载Jenkins等步骤,文章末尾强调了这是个人经验,仅供参考
2026-05-05
Mac M1安装Homebrew的方法步骤
这篇文章主要介绍了Mac M1安装Homebrew的方法步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2021-03-03
Windows环境git配置多个ssh的实现步骤
本文主要介绍了在Windows环境下解决SSH连接GitHub持续要求密码的问题
2025-06-06
win11 C盘出现锁和黄色感叹号的解决方法
这篇文章主要介绍了win11 C盘出现锁和黄色感叹号的解决方法，文中有详细的解决方案，对大家的解决问题有一定的帮助,需要的朋友可以参考下
2007-02-02
git使用rebase删除某次提交的问题
文章介绍了Git删除特定commit的两种方法：通过`git rebase -i HEAD~n`交互式删除最近提交,需修改操作为`drop`并强制推送到远程；或使用`git rebase --abort`撤销操作,同时提醒处理空提交时需检查暂存区文件
2025-09-09
git如何合并某个分支的某次提交(cherry-pick)
这篇文章主要介绍了git如何合并某个分支的某次提交(cherry-pick)问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-05-05