如何从 Git 存储库中删除文件而不在本地删除它

Mia Chevalier

2024年6月22日星期六下午8:06:06

管理 Git 文件而不进行本地删除
使用 Git 时，有时您可能希望从存储库中删除文件，而不会将其从本地文件系统中丢失。对于需要从版本控制中排除某些文件但仍保留它们以供本地使用的开发人员来说，这是一种常见情况。了解如何实现这一点可以节省时间并防止潜在的数据丢失。
典型的“git rm”命令将从存储库和本地文件系统中删除文件，这并不总是可取的。幸运的是，Git 提供了一种从存储库中删除文件的方法，同时保持本地副本完好无损。在本指南中，我们将探讨有效完成此任务的步骤。

命令描述

git reset HEAD <file> 从当前提交中取消指定文件，但将其保留在本地文件系统中。

git rm --cached <file> 从 Git 索引（暂存区域）中删除指定的文件，而不将其从本地文件系统中删除。

echo "<file>" >>echo "<file>" >> .gitignore 将指定的文件添加到 .gitignore 文件中，以防止在将来的提交中跟踪它。

git add .gitignore 暂存 .gitignore 文件，以便对其所做的更改将包含在下一次提交中。

git commit -m "<message>" 将分阶段的更改提交到存储库，并带有描述更改的消息。

命令	描述
git reset HEAD <file>	从当前提交中取消指定文件，但将其保留在本地文件系统中。
git rm --cached <file>	从 Git 索引（暂存区域）中删除指定的文件，而不将其从本地文件系统中删除。
echo "<file>" >>echo "<file>" >> .gitignore	将指定的文件添加到 .gitignore 文件中，以防止在将来的提交中跟踪它。
git add .gitignore	暂存 .gitignore 文件，以便对其所做的更改将包含在下一次提交中。
git commit -m "<message>"	将分阶段的更改提交到存储库，并带有描述更改的消息。

Git文件删除脚本详解

提供的脚本旨在从 Git 存储库中删除文件，而不将其从本地文件系统中删除。第一个脚本使用一系列 Git 命令来实现此目的。最初，命令用于取消暂存文件，确保它不是下一次提交的一部分。在此之后，命令从 Git 索引中删除该文件，有效地告诉 Git 停止跟踪该文件，而不在本地删除它。这些步骤至关重要，因为它们可以防止本地副本丢失，同时确保文件不再是存储库的一部分。

下一个重要步骤是将文件添加到使用命令文件。此步骤对于确保文件在将来的提交中保持不被跟踪是必要的，从而避免意外的重新添加。一旦文件已更新，需要使用以下命令暂存该文件以供下一次提交 git add .gitignore。最后，使用以下命令将更改提交到存储库。此提交有效地完成了该过程，正式从存储库中删除，同时保持本地副本完好无损。

第二个脚本提供了使用 Bash 脚本的自动化方法。功能将前面提到的所有命令封装到一个可重用的函数中。该函数接受文件名作为参数，以便轻松地重复使用不同的文件。通过使用所需的文件名运行该函数，它会执行所有必要的步骤来取消暂存、从索引中删除、更新 .gitignore 以及提交更改，从而确保为需要频繁执行此任务的用户提供简化的流程。

如何从 Git 存储库中排除文件，同时将其保留在本地

使用 Git 命令行

# Step 1: Ensure the file is not currently staged
git reset HEAD file_to_remove.txt

# Step 2: Remove the file from the index
git rm --cached file_to_remove.txt

# Step 3: Add the file to .gitignore to prevent future commits
echo "file_to_remove.txt" >> .gitignore

# Step 4: Commit the changes
git add .gitignore
git commit -m "Remove file_to_remove.txt from repository but keep it locally"

使用 Shell 脚本从 Git 存储库中排除文件

使用 Bash 脚本

#!/bin/bash

# Function to remove file from Git repository but keep it locally
remove_file_from_git() {
  local file=$1
  git reset HEAD $file
  git rm --cached $file
  echo "$file" >> .gitignore
  git add .gitignore
  git commit -m "Remove $file from repository but keep it locally"
}

# Usage
remove_file_from_git "file_to_remove.txt"

从 Git 存储库中删除文件而不影响本地文件系统

处理 Git 存储库中的文件的另一个重要方面是了解 .gitignore 的含义以及它如何与跟踪和未跟踪的文件交互。当您将文件添加到 .gitignore 时，它会告诉 Git 停止跟踪该文件，这对于应保留在本地计算机上但不属于存储库一部分的文件非常有用，例如配置文件或本地开发环境。但是，请务必注意 .gitignore 仅影响未跟踪的文件。如果文件已被 Git 跟踪，则将其添加到 .gitignore 不会产生任何效果，直到您使用以下命令将其从索引中删除。

除了 .gitignore 之外，您可以使用的另一个工具是 .gitkeep。虽然 .gitkeep 不是官方的 Git 功能，但它是用于在存储库中保留空目录的约定。 Git 不跟踪空目录，因此如果需要在没有文件的情况下保持目录结构完整，可以在空目录中放置 .gitkeep 文件。此方法在目录结构对于项目的构建或部署过程非常重要的项目中非常有用。将 .gitkeep 与 .gitignore 一起使用可以帮助维护必要的本地目录结构，而不会用不必要的文件使存储库混乱。

如何从 Git 索引中删除文件但将其保留在本地？
使用命令从索引中删除文件，同时将其保留在本地文件系统上。
.gitignore 的目的是什么？
用于指定 Git 应忽略而不跟踪的文件或目录。
我可以使用 .gitignore 停止跟踪已被跟踪的文件吗？
不，您必须首先使用以下命令从索引中删除文件然后将其添加到 .gitignore。
如果我从存储库中删除文件但不将其添加到 .gitignore 中，会发生什么情况？
如果您不将其添加到 .gitignore，则当文件被修改并暂存以进行提交时，Git 可能会再次跟踪该文件。
如何自动执行从 Git 中删除文件并将其保存在本地的过程？
您可以创建一个使用以下命令的 shell 脚本和使该过程自动化。
什么是 .gitkeep 以及如何使用它？
是一个占位符文件，用于确保在存储库中跟踪空目录。
为什么 Git 不跟踪空目录？
Git 仅跟踪文件，因此空目录将被忽略，除非它们至少包含一个文件。
我可以一次从 Git 索引中删除多个文件吗？
是的，您可以使用同时从索引中删除多个文件。
有没有办法可视化 Git 忽略的文件？
您可以使用列出所有被忽略的文件和目录。

管理 Git 存储库中的文件需要清楚地了解如何从索引中删除文件而不影响本地副本。通过使用诸如和，您可以确保文件不被存储库跟踪，同时保留在本地文件系统上。此过程有助于维护不需要在存储库中共享或版本控制的基本本地文件。

使用 shell 脚本自动执行此过程可以进一步简化任务，从而允许跨不同文件和项目进行高效且可重复的操作。手动命令和脚本的结合提供了一种灵活的方法来管理 Git 中的文件跟踪，确保本地开发需求和存储库清洁之间的平衡。