跟踪新文件(git add)

跟踪新文件(git add)

Git 的核心功能之一就是跟踪文件的变化。当你在项目中创建了新文件，或者修改了现有文件，Git 并不会自动记录这些变化。你需要明确告诉 Git 哪些文件需要被纳入版本控制。这就是 git add 命令的用途。

git add 的基本用法

git add 命令用于将文件添加到暂存区（staging area）。暂存区是 Git 工作流程中的一个中间区域，它允许你在提交之前精心挑选要包含在下次提交中的更改。

最基本的用法是添加单个文件：

git add filename.txt

你也可以添加多个文件，只需将它们依次列出：

git add file1.txt file2.txt file3.js

添加所有新文件和修改过的文件

如果你想一次性添加所有新文件和修改过的文件（不包括被删除的文件），可以使用：

git add .

. 表示当前目录及其所有子目录。这个命令会递归地添加所有新文件和修改过的文件。

如果你还想包括被删除的文件，可以使用 -A 或 --all 选项：

git add -A

交互式添加

Git 提供了一个交互模式，让你可以更精细地控制要暂存哪些更改：

git add -i

或者使用更现代的交互式界面：

git add -p

-p 或 --patch 选项允许你逐个查看更改，并决定是否要暂存它们。这对于大型修改特别有用，因为你可以将一次大的修改分解为多个逻辑上独立的提交。

添加文件的部分更改

有时候，你可能只想暂存文件中的部分更改，而不是整个文件。Git 允许你这样做：

git add -p filename.js

这会打开一个交互式界面，显示文件中的每一块更改。对于每一块，你可以选择：

• y：暂存该块
• n：不暂存该块
• q：退出
• a：暂存该块和文件中所有剩余的块
• d：不暂存该块和文件中所有剩余的块
• /：搜索正则表达式匹配的块
• s：将当前块分割成更小的块
• e：手动编辑当前块
• ?：显示帮助

撤销已暂存的更改

如果你不小心暂存了不需要的文件，可以使用以下命令取消暂存：

git reset HEAD filename.txt

或者取消所有已暂存的更改：

git reset

特殊情况处理

添加空目录

Git 不会跟踪空目录。如果你想在仓库中保留一个空目录（通常是为了保留目录结构），可以在目录中创建一个空的 .gitkeep 文件：

mkdir empty_directory
touch empty_directory/.gitkeep
git add empty_directory/.gitkeep

添加大文件

对于大文件，通常建议使用 Git LFS（Large File Storage）而不是直接添加到 Git：

git lfs track "*.psd"
git add .gitattributes
git add file.psd

忽略已跟踪的文件

如果你想停止跟踪某个文件，但保留在本地工作目录中：

git rm --cached filename.txt

这会将文件从 Git 的跟踪列表中移除，但不会删除物理文件。

实际应用示例

假设我们有一个前端项目，结构如下：

project/
├── index.html
├── css/
│   └── style.css
└── js/
    └── app.js

场景1：添加新创建的文件

你刚刚创建了一个新的 JavaScript 文件：

touch js/utility.js
git add js/utility.js

场景2：添加修改过的文件

你修改了 CSS 文件：

git add css/style.css

或者添加所有修改过的文件：

git add .

场景3：交互式添加

你对 app.js 做了多处修改，但想分开提交：

git add -p js/app.js

在交互界面中，你可以选择性地暂存相关修改。

自动化脚本中的使用

在自动化脚本中，你可能需要更精确地控制 git add 的行为。例如，在一个部署脚本中：

#!/bin/bash

# 只添加构建后的文件
git add -f dist/*

# 或者添加特定类型的文件
git add *.html *.css *.js

常见问题解决

添加了错误的文件

如果你不小心添加了错误的文件，可以撤销：

git reset HEAD wrongfile.txt

文件被忽略但仍然被添加

如果文件在 .gitignore 中但仍然被添加，可能是因为它之前已经被跟踪了。强制 Git 忽略它：

git rm --cached file-to-ignore

权限变化被检测为修改

Git 会检测文件权限的变化。如果你不关心权限变化，可以配置：

git config core.fileMode false

高级技巧

使用通配符

你可以使用通配符来添加特定类型的文件：

git add *.js

添加除某些文件外的所有文件

使用 :(exclude) 语法：

git add . ":(exclude)*.log"

查看将要添加的内容

在真正添加之前，可以先查看哪些文件会被添加：

git add -n .

与其他命令的配合

git add 通常与以下命令配合使用：

git add .
git commit -m "描述信息"
git push

或者在一个更复杂的工作流中：

git add -p
git commit -m "部分修改"
git add .
git commit -m "剩余修改"

性能考虑

对于大型仓库，git add . 可能会比较慢。在这种情况下，可以：

1. 只添加必要的文件
2. 使用 .gitignore 排除不需要的文件
3. 考虑使用 git add -u 只添加已跟踪的文件

最佳实践

1. 小步提交：频繁地添加和提交小的、逻辑上独立的更改
2. 审查更改：在添加前使用 git diff 查看更改
3. 使用交互模式：特别是当一次修改涉及多个不相关的更改时
4. 保持暂存区整洁：只添加准备提交的更改
5. 利用.gitignore：避免意外添加不需要的文件

与其他版本控制系统的比较

与 SVN 不同，Git 的 add 命令不是必须的（在 SVN 中创建新文件后必须 svn add）。Git 的 add 更多是关于选择要提交的内容，而不是声明要跟踪的文件。

底层原理

当你运行 git add 时，Git 会：

1. 计算文件的 SHA-1 哈希
2. 将文件内容存储在 .git/objects 目录中
3. 更新索引（.git/index 文件）以记录文件的状态

这解释了为什么 git add 有时被称为 "将文件暂存" 或 "将文件添加到索引"。

危险操作警告

1. git add . 会添加所有文件，包括可能的大文件或敏感信息
2. 添加的文件会包含在下次提交中，可能被推送到远程仓库
3. 特别注意不要添加密码、密钥或个人信息

实际案例：前端项目工作流

假设你在开发一个 React 应用：

1. 创建新组件：

touch src/components/NewComponent.js

2. 编写组件代码后，添加它：

git add src/components/NewComponent.js

3. 修改了现有组件和样式：

git add -p src/components/ExistingComponent.js
git add src/styles/main.css

4. 准备提交：

git commit -m "添加新组件并更新现有组件样式"

自动化 linting 与添加

你可以设置 pre-commit 钩子，在添加文件时自动运行 linting：

#!/bin/sh
npm run lint
git add .

处理合并冲突后的添加

解决合并冲突后，你需要添加解决后的文件：

git add conflicted-file.js

可视化工具中的使用

大多数 Git 图形界面工具（如 GitHub Desktop、GitKraken）都提供了可视化的方式来暂存文件，通常是通过复选框来选择要暂存的更改。

批处理操作

你可以组合多个 Git 命令：

git add . && git commit -m "批量添加并提交"

或者更复杂的操作：

git add src/ && git commit -m "添加源文件" && git add tests/ && git commit -m "添加测试"

文件状态的生命周期

理解 git add 需要了解 Git 中文件的状态周期：

1. Untracked：新文件，Git 尚未跟踪
2. Modified：已跟踪文件被修改
3. Staged：通过 git add 暂存修改
4. Committed：通过 git commit 提交修改

git add 将文件从 untracked 或 modified 状态转为 staged 状态。

环境变量影响

某些环境变量会影响 git add 的行为：

GIT_EDITOR=nano git add -p  # 使用nano作为交互式编辑的编辑器

跨平台注意事项

Windows 和 Unix-like 系统在文件路径和换行符处理上有所不同。Git 可以自动处理这些差异：

git config --global core.autocrlf true  # Windows
git config --global core.autocrlf input # Linux/Mac

调试 git add

如果 git add 行为不符合预期，可以启用跟踪：

GIT_TRACE=1 git add .

插件和扩展

一些 Git 插件增强了 git add 的功能，比如 git-extras 中的 git add-from 可以从另一个分支添加文件。

历史演变

git add 的功能在 Git 的不同版本中有所增强。例如，较新的版本改进了交互模式 (-p) 的用户体验。