如何将文件添加到暂存区？

暂存区是什么？

在深入了解命令之前，有必要先理解暂存区的角色。你可以把它想象成一个“待提交”的缓冲区。

当你在工作区（Working Directory）修改了文件后，这些变更并不会直接成为下一次提交的内容。你需要通过 git add 命令，将希望提交的变更“挑选”出来，放入暂存区。这个设计让你可以将一次大的修改拆分成多个逻辑清晰的小提交，而不是把所有改动都混在一起。

这样做的好处是，你的每一次提交都只包含相关的、完整的变更，使得版本历史更清晰，也为日后的代码审查和问题追溯提供了便利。

git add 的基础用法

git add 命令的用法非常灵活，可以满足从单个文件到整个项目的暂存需求。

添加单个或多个指定文件

这是最精确的暂存方式，你可以明确指定要添加哪些文件。

如果你只想暂存一个文件，比如 README.md，可以运行：

git add README.md

如果需要同时暂存多个文件，只需将文件名依次列出即可：

git add main.js styles.css

这种方法能确保只有你明确指定的文件变更会被暂存，有效避免了误操作。

添加当前目录下的所有变更

当你需要暂存当前目录下所有的文件变更时，使用 . 会非常方便。

git add .

这里的 . 代表当前目录。这个命令会暂存当前目录及其所有子目录下所有新增、修改和删除的文件。它是一个高效的批量操作，但在执行前最好使用 git status 确认一下变更内容，以防将不需要的文件也添加进去。

应对不同场景的 git add 参数

除了基础用法，git add 还提供了一些参数，帮助你更精细地控制暂存行为。

只暂存已修改和已删除的文件

有时，你可能只想暂存那些已经被 Git 追踪的文件的变更（即修改和删除），而暂时忽略新创建的文件。这时 -u 参数就派上用场了。

git add -u

命令中的 -u 是 --update 的缩写。这个命令对于只想提交对现有代码的改动，而不想引入新文件的场景非常有用。

暂存所有变更

如果你确认工作区内的所有变更（包括新增、修改和删除的文件）都需要被暂存，可以使用 -A 参数。

git add -A

-A 是 --all 的缩写。在较新的 Git 版本中，git add . 和 git add -A 在项目根目录下执行时的效果几乎相同。但 -A 的语义更明确，意为“暂存工作区中的所有变更”，无论你在哪个子目录下执行该命令，它都会作用于整个项目。因此，它通常被认为是一个更清晰、更不容易出错的选择。

进行交互式暂存

当你对一个文件做了多处不相关的修改，并希望将它们分到不同的提交中时，交互式的 -p 参数是最佳选择。

git add -p

-p 是 --patch 的缩写。执行后，Git 会逐一展示文件中的每一处修改（称为“hunk”），并询问你是否要暂存该部分。你可以输入 y (yes) 来暂存，输入 n (no) 来忽略，或者输入 s (split) 尝试将一个大的修改块拆分成更小的块。这是一种非常强大的技术，能帮助你创建出逻辑性极强的提交历史。

检查暂存区状态

在执行 git commit 之前，检查暂存区的内容是一个好习惯。git status 命令可以清晰地展示当前工作区和暂存区的状态。

git status

执行后，终端会列出“Changes to be committed”下面的文件，这些就是已经位于暂存区、等待提交的变更。而“Changes not staged for commit”下面的文件，则是还停留在工作区的变更。

常见问题与注意事项

不小心添加错了文件怎么办？

如果你错误地将某个文件添加到了暂存区，可以使用 git restore 命令将其撤销。

git restore --staged <file_name>

这个命令会将文件从暂存区移出，但保留你在工作区所做的修改。在旧版本的 Git 中，你可能需要使用 git reset HEAD <file_name> 来达到同样的效果。

为什么有些文件无法被添加？

如果发现某些文件（如编译产物、日志文件）无法通过 git add . 或 git add -A 添加到暂存区，请检查项目根目录下是否存在一个名为 .gitignore 的文件。

这个文件定义了 Git 需要忽略的文件和目录的规则。被 .gitignore 规则匹配到的文件会被 Git 有意忽略，这是一种保护机制，用于防止将不必要的或敏感的文件提交到版本库中。

总结与下一步

git add 是连接你的工作区和版本历史的关键桥梁。掌握它的不同用法，可以让你更自如地管理代码变更。

• 对于精确控制，使用 git add <file_name>。
• 对于批量操作，git add . 和 git add -A 是高效的选择。
• 对于更复杂的场景，-u 和 -p 参数提供了更精细的控制粒度。

当你将所有需要的变更都妥善地放入暂存区后，下一步就是使用 git commit 命令，将这些变更永久地记录到项目的版本历史中。