Git 忽略已提交过的文件夹 完整步骤

你遇到的是最常见的场景：文件 / 文件夹已经提交到仓库了，现在想让 Git 不再追踪它、不再提交。

直接写 .gitignore 是无效的，必须按下面步骤操作👇

一、先在 .gitignore 里添加要忽略的文件夹

在项目根目录创建 / 编辑 .gitignore，加入你要忽略的文件夹：

# 比如要忽略 dist/ 文件夹
dist/

二、执行命令，把已提交的文件夹从 Git 追踪中删除

这一步不会删除你本地文件！放心执行

# 把 文件夹名 换成你要忽略的真实文件夹
git rm -r --cached 文件夹名/

示例：

git rm -r --cached dist/

作用：

• 只删除Git 仓库里的追踪记录

• 本地文件完全保留

三、提交这次修改

git add .
git commit -m "忽略 文件夹名 不再提交"

四、完成！

从此以后：

• 这个文件夹不会再被提交

• 本地文件正常保留

• .gitignore 会永久生效

完整示例（你直接复制改个名就能用）

# 1. 编辑 .gitignore，加入：dist/

# 2. 取消 Git 追踪（不删本地文件）
git rm -r --cached dist/

# 3. 提交
git add .
git commit -m "忽略 dist 文件夹"

总结

1. 已提交过的文件，必须先取消追踪，.gitignore 才会生效

2. git rm -r --cached 文件夹名/ 是核心命令（安全不删本地）

3. 之后再也不会提交这个文件夹了

由AI生成