如何在 Git 中暂存特定文件

简介

Git 是一个强大的版本控制系统，它允许开发者有效地管理他们的代码库。在本教程中，我们将探索在 Git 中选择性暂存文件的过程，使你能够对你的提交历史和工作流程有更多的控制权。通过理解 Git 暂存的复杂性，你将能够简化你的开发过程，并维护一个干净、有条理的仓库。

Skills Graph

理解 Git 暂存

什么是 Git 暂存？

Git 暂存是 Git 版本控制系统中的一个关键概念。它指的是准备要提交到仓库的更改的过程。当你对文件进行更改时，Git 不会自动记录这些更改。相反，你需要通过“暂存”文件来明确指定要包含在下一次提交中的文件。

Git 暂存区

Git 暂存区，也称为“索引”，是一个临时存储区域，你可以在将更改提交到仓库之前在其中收集一组更改。这使你能够有选择地决定在下一次提交中包含哪些修改，而让其他更改保持未暂存状态。

暂存工作流程

典型的 Git 工作流程包括以下步骤：

1. 进行更改：在工作目录中修改一个或多个文件。
2. 暂存更改：使用 git add 命令将你想要包含在下一次提交中的文件添加到暂存区。
3. 提交更改：使用 git commit 命令将你暂存的更改创建一个新的提交。

通过将暂存和提交步骤分开，Git 为你提供了组织更改并创建有意义的原子提交的灵活性。

暂存的好处

在 Git 中暂存文件有几个好处：

1. 选择性提交：你可以选择在一次提交中包含哪些更改，从而能够创建更有针对性和更有意义的提交。
2. 部分提交：你可以只暂存更改的一个子集，这使得管理复杂的工作流程以及同时处理多个功能变得更加容易。
3. 撤销错误：如果你不小心暂存了你不打算暂存的文件，你可以在提交之前取消暂存。
4. 协作工作：暂存有助于你组织更改，使你更容易与其他开发人员在同一代码库上进行协作。

理解 Git 暂存区及其在整个工作流程中的作用对于有效地管理项目历史记录和维护一个干净、有条理的仓库至关重要。

选择性暂存文件

暂存单个文件

要在 Git 中暂存单个文件，你可以使用 git add 命令，后跟文件路径。例如：

git add file1.txt
git add file2.js

这会将指定的文件添加到暂存区，为下一次提交做好准备。

暂存目录

你也可以通过将目录路径提供给 git add 命令来暂存整个目录：

git add my-project/

这会暂存 my-project/ 目录内所有已修改的文件。

暂存块（部分暂存）

Git 还允许你使用 git add --patch 命令暂存单个“块”（文件内的更改）。当一个文件中有多个更改，而你只想在下一次提交中包含其中一些时，这很有用。

git add --patch file.txt

这会打开一个交互式提示符，让你检查每个块并决定是否暂存它。

取消暂存文件

如果你不小心暂存了一个文件，或者想从暂存区中移除一个文件，可以使用 git restore --staged 命令：

git restore --staged file.txt

这会将文件从暂存区移除，但它仍会存在于你的工作目录中。

暂存工作流程示例

以下是一个典型的选择性暂存工作流程示例：

1. 对多个文件 file1.txt、file2.js 和 file3.py 进行更改。
2. 仅暂存 file1.txt 和 file2.js：

   git add file1.txt file2.js

3. 使用 git status 检查暂存的更改。
4. 取消暂存 file2.js：

   git restore --staged file2.js

5. 使用 git add --patch file3.py 暂存 file3.py 中的部分更改。
6. 提交暂存的更改：

   git commit -m "Implement feature X"

通过选择性地暂存文件，你可以创建更有意义、更有条理的提交，改善整个项目历史记录，并使与其他开发人员协作变得更容易。

高级暂存工作流程

暂存特定块

如前所述，Git 允许你使用 git add --patch 命令暂存单个块（文件内的更改）。当一个文件中有多个不相关的更改，而你只想在下一次提交中包含特定更改时，这特别有用。

git add --patch file.txt

这将打开一个交互式提示符，让你检查每个块并决定是否暂存它。这对于维护干净且有条理的提交历史记录来说是一个强大的工具。

按模式暂存

Git 还支持使用带有 -p 或 --patch 选项的 git add 命令，基于模式暂存文件。当你想要暂存一组匹配特定模式的文件，而不必逐个列出它们时，这很有用。

git add -p "*.js"

这将暂存工作目录中所有已修改的 JavaScript 文件。

使用忽略文件暂存

Git 允许你创建 .gitignore 文件，以指定 Git 应忽略哪些文件或目录。当你想要避免意外暂存某些类型的文件（如编译后的二进制文件、日志或临时文件）时，这会很有用。

## 示例.gitignore 文件
*.log
*.pyc
build/

通过使用 .gitignore 文件，你可以专注于仅暂存提交中相关的文件，保持仓库的干净和有条理。

已暂存与未暂存的更改

了解 Git 工作流程中已暂存和未暂存更改之间的区别很重要。已暂存的更改是那些已添加到暂存区并将包含在下一次提交中的更改。未暂存的更改是尚未添加到暂存区且不会包含在下一次提交中的修改。

你可以使用 git status 命令查看更改的状态：

git status

这将显示哪些文件已被修改、哪些文件已暂存以及哪些文件未暂存。

与 LabEx 工具集成

LabEx 提供了一套工具，可以增强你的 Git 工作流程。例如，LabEx CLI 包含一些命令，可以简化暂存和提交更改的过程。通过将 LabEx 集成到你的开发过程中，你可以简化基于 Git 的工作流程并提高整体生产力。

请记住，有效进行 Git 暂存的关键是开发一种适合你的项目和团队的一致且有条理的工作流程。通过掌握本教程中介绍的技术，你将在基于 Git 的项目中很好地维护干净且有意义的提交历史记录。

总结

对于任何开发者来说，掌握 Git 中选择性文件暂存的技巧都是一项至关重要的技能。在这本全面的指南中，你已经学会了如何理解 Git 暂存过程、有选择地暂存文件以及实施高级暂存工作流程。通过运用这些技术，你可以维护一个干净的提交历史记录，更有效地与团队协作，并确保代码库的完整性。掌握这些 Git 技能后，你将能够把版本控制管理提升到一个新的水平。