从 Git 仓库中移除已推送的文件¶

本文介绍如何从 Git 仓库中移除一个已经被推送到远程的文件或目录，同时保留本地文件。

操作步骤¶

1. 将文件添加到 .gitignore¶

首先，编辑项目根目录下的 .gitignore 文件，添加需要忽略的文件或目录路径：

# 添加需要忽略的文件或目录
path/to/file/or/directory/

例如，要忽略 documentation/.cache 目录：

documentation/.cache/

2. 从 Git 缓存中移除¶

使用 git rm 命令从 Git 缓存中移除文件，但保留本地文件：

git rm -r --cached path/to/file/or/directory

参数说明： - -r: 递归删除目录及其内容 - --cached: 只从 Git 索引中删除，保留本地文件

例如：

git rm -r --cached documentation/.cache

3. 提交更改¶

提交 .gitignore 文件的更改和缓存的删除操作：

git add .gitignore
git commit -m "chore: ignore specific files/directories"

4. 推送到远程仓库¶

将更改推送到远程仓库：

git push origin master

操作结果¶

完成上述步骤后： - 指定的文件/目录会从 Git 历史中被移除 - 本地文件会保留在文件系统中 - 后续对该文件/目录的更改不会被 Git 跟踪 - 其他开发者在拉取代码后，这些文件/目录也不会被 Git 跟踪

注意事项¶

1. Git 历史
2. 这个操作会修改 Git 历史

3. 文件仍然存在于之前的提交历史中

4. 团队协作

5. 如果其他开发者已经克隆了仓库，他们需要：

   • 删除这些文件并重新克隆仓库
   • 或者执行相同的步骤来停止跟踪这些文件

6. 敏感信息

7. 如果要移除的是敏感信息（密码、密钥等）
8. 应该立即更改这些信息

9. 因为它们仍然存在于 Git 历史中

10. 备份

11. 执行操作前最好先备份重要文件
12. 确保不会意外删除重要数据

最佳实践¶

1. 在项目开始时就做好 .gitignore 配置
2. 定期检查是否有不应该被跟踪的文件
3. 对于敏感信息，使用环境变量或配置文件模板
4. 在提交前仔细检查 git status 的输出