【git 实用指南】git 增加 本地代码 git add 相关命令和复杂情况需求

目录标题

---

1. 简介

1.1 Git的基础概念

Git（分布式版本控制系统）是一个开源的版本控制系统，用于追踪文件和目录的更改。Git不仅仅是一个备份系统，它也允许多人协作。这让我想到了Bjarne Stroustrup（C++之父）的名言：“C++是为解决实际问题而设计的”。Git也是这样，它为解决现实世界中版本控制的复杂问题而生。

“C makes it easy to shoot yourself in the foot; C++ makes it harder, but when you do it blows your whole leg off.”
— Bjarne Stroustrup

1.2

git add

的重要性

在Git工作流中，

git add

命令是非常关键的一步。它负责将您的更改从工作目录（Working Directory）移动到暂存区（Staging Area）。只有在暂存区的更改才会被包括在下一个提交（Commit）中。这就像是一个预演，在您真正提交之前，您可以在这个阶段查看、修改您的更改。

1.2.1 暂存区（Staging Area）

暂存区是一个介于工作目录和仓库（Repository）之间的区域。它允许您精细控制哪些更改应该被提交。这一点非常重要，因为不是所有的更改都是等价的。有些更改可能是实验性的，有些则可能是关键的。暂存区允许您分别处理它们。

“The first draft is just you telling yourself the story.”
— Terry Pratchett

这里，您可以将暂存区看作是一个“草稿箱”，允许您多次编辑、优化代码，直到它准备好被提交。

1.2.2

git add

的工作原理

当您执行

git add

命令时，Git会更新索引（Index）以包括新的或已修改的文件。这些更改会被存储在一个名为“blob”的对象中，这些对象又会被存储在Git对象数据库中。

// 示例代码：C++ Hello World#include<iostream>intmain(){
    std::cout <<"Hello, World!"<< std::endl;return0;}

在这个C++示例中，如果您对

main.cpp

文件进行了修改，然后执行

git add main.cpp

，Git会将这些更改添加到暂存区。
方法描述应用场景

git add <file>

将单个文件添加到暂存区单一文件更改

git add .

将所有更改添加到暂存区批量文件更改

git add -u

将所有已跟踪（但已修改）的文件添加到暂存区忽略新文件
通过这种方式，

git add

允许您在提交之前仔细审查更改。就像编写C++代码时，你可能会先在草稿或测试环境中进行多次迭代，然后再进行最终提交。

2. 基础用法

2.1 添加单个文件：

git add <filename>

在C/C++项目中，源代码文件（

.c

,

.cpp

,

.h

等）经常会被频繁地修改。当你完成了一个函数或者修复了一个bug，第一步通常是使用

git add <filename>

将这些改动添加到Git的暂存区（Staging Area，暂存区）。

这个命令是最直接的，就像C++中的

std::vector::push_back()

方法一样：简单而直接。使用这个命令，你可以精确地控制哪些文件被添加到暂存区。

代码示例

gitadd main.cpp

通过这个命令，只有

main.cpp

文件的改动会被添加到暂存区。

2.2 添加多个文件：

git add <filename1> <filename2> ...

如果你一次性修改了多个文件，比如添加了一个类（Class）和相应的头文件，你可能想一次性将所有这些更改添加到暂存区。

代码示例

gitadd main.cpp utils.h utils.cpp

这与C++中的函数重载（Function Overloading）有些相似：同一个函数名，但不同的参数列表。

2.3 添加所有文件：

git add .

在项目的生命周期中，有时你可能会进行大规模的更改，包括添加新文件、修改旧文件，甚至删除一些文件。这时，

git add .

就显得特别有用。

代码示例

gitadd.

这就像是在C++中使用

std::vector::assign()

来一次性更新整个数组。

注意事项

使用

git add .

需要谨慎，因为它会添加所有未被

.gitignore

文件排除的更改。这可能会导致一些不想提交的文件或敏感信息被添加到暂存区。
命令应用场景优点缺点

git add <filename>

添加单个文件精确控制需要指定文件名

git add <filename1> <filename2> ...

添加多个文件精确控制多个文件需要列出所有文件名

git add .

添加所有文件一键添加所有更改可能添加不想提交的文件

2.4 实用小技巧

• 快速添加并提交（Quick Add and Commit）: 使用git commit -am "Your Message"可以快速添加所有已跟踪的（tracked）文件并提交。
• 检查状态（Check Status）: 在使用git add之前，运行git status来查看哪些文件已修改或新添加。

应用场景与心理动机

人们倾向于使用最简单、最直接的工具来完成任务。这是因为工具的简单性直接影响我们完成任务的速度和效率，就像C++标准库中高度优化的算法和数据结构。

在使用

git add

时，根据不同的需求和场景灵活选择添加方式，就像在C++中根据需求选择不同的数据结构和算法。这样做不仅使工作更高效，还能让你更好地掌握工具，进而更自信地面对更复杂的问题。

“知道如何做事和知道什么是最好的工具，这两者同样重要。”这句话同样适用于使用Git和编程。知道

git add

的各种用法和最佳场景，就像知道C++中的各种设计模式和最佳实践一样，都是成为更高效、更成功的开发者的关键。

3. 添加特定类型的文件更改

在编程的世界里，变化是唯一不变的事情。你可能正在为一个大型C++项目添加新的库，修复现有代码中的bug，或者仅仅是更新了几行注释。当你面对这样一个持续变化的环境时，你的“暂存区（Staging Area）”应该是灵活且细致的。这就是本章的主题：如何精准地控制你想要暂存的文件和更改。

3.1 只添加已修改（Modified）的文件

让我们从一种非常常见但经常被忽视的情况开始讲解：你只想暂存已经修改过的文件。

3.1.1 使用

git add -u

git add -u

只会添加那些已经被 Git 跟踪并且被修改了的文件。这意味着，任何新的文件（Untracked Files）或者被删除的文件都不会被添加到暂存区。

gitadd-u

这就像是你有一堆杂乱的工具（文件）散落在桌子上，而你只拿起那些你实际用过（已修改）的工具放进工具箱（暂存区）里。这样，当你准备好提交时，你就可以确保只提交了那些确实需要更新的文件。

适用场景

• 代码重构：当你正在对现有的C++代码进行重构，这个命令会非常有用。
• 小型更新：比如修复了一个bug，但并没有添加新文件。

注意事项

• 这不会添加新文件（Untracked Files）。
• 如果你删除了一个文件，这个命令也不会处理。
  命令新文件（Untracked）已修改（Modified）已删除（Deleted）

  git add .
  

  ✔️✔️✔️

  git add -u
  

  ❌✔️❌

  3.1.2 从底层源码看

  git add -u
  

git add -u

的核心逻辑在于它会遍历

.git/index

文件，这个文件包含了所有已经被Git跟踪的文件的元数据。通过比较工作目录中的文件与

.git/index

中的记录，Git能够找出哪些文件已经被修改。

这种方法很像C++中的

std::set

和

std::map

，这两者都是高度优化的数据结构，用于快速地查找和比较元素。当你有一个巨大的项目和数百个已经修改的文件时，这种效率是非常关键的。

3.2 添加新文件（Untracked）

在大多数情况下，新增的文件都是项目发展中不可或缺的一部分。这就像为你的代码库添加新的“DNA片段”，每一个文件都有其特定的目的和功能。

3.2.1 使用通配符

当你要添加特定类型的新文件时，通配符（Wildcard）是一个非常方便的工具。

gitadd *.cpp

这条命令会添加所有扩展名为

.cpp

的新文件。这就像你有一个“魔法筛子”，只捞出你需要的那部分。

适用场景

• 当你添加了一系列新的C++源文件。
• 当你从其他项目中拷贝了一批特定类型的文件。

注意事项

• 这不会添加已经被 .gitignore 排除的文件。
• 确保你的通配符表达式不会意外匹配到不想添加的文件。

在实际编程中，选择正确的文件进行暂存就像是在进行一次“代码审查”。你不仅需要考虑这个文件是否应该被添加，还需要考虑它是否符合项目的整体架构和设计原则。

通过精心选择要暂存的文件和更改，你不仅可以保持项目的整洁，还可以更有效地与团队成员进行沟通。这种“聚焦”是编程中一个经常被低估的艺术，但在实际操作中却极其重要。

4. 使用路径规格

在一个大型项目中，特别是在C/C++领域，文件和目录结构可能会非常复杂。这种复杂性不仅仅是代码的复杂性，还体现在如何有效地管理这些文件。就像在C++中使用类（Class）和头文件（Header files）来组织代码一样，

git add

提供了灵活的方式来根据路径和文件类型添加文件到暂存区。

4.1 添加子目录中的文件

想象一下，你正在开发一个C++项目，其中有一个名为

src

的子目录，它包含所有的源文件（

.cpp

）。你可能只想把这个目录中修改过的文件添加到暂存区。在这种情况下，你可以使用：

gitadd src/*

这样，只有

src

目录下的文件会被添加。这类似于在C++中使用命名空间（Namespace）来限定函数或变量的作用范围。

4.2 使用通配符

如果你要添加所有以

.cpp

结尾的文件，无论它们在哪个目录下，你可以使用：

gitadd *.cpp

这种方法让你能够更精确地控制哪些文件被添加到暂存区，就像在C++中通过函数重载（Function Overloading）来控制哪个函数版本被调用。

4.2.1 注意事项

通配符（Wildcard）虽然方便，但也有局限性。比如，它不能匹配隐藏文件或者跨越多个目录。要解决这个问题，你可能需要使用更高级的文件选择工具，比如

find

命令。
方法优点缺点最佳用例

git add <dir>/*

精确，易于理解只限于一个目录添加特定目录的所有文件

git add *.ext

精确，跨目录不能匹配子目录添加所有特定类型的文件

find . -name

最灵活语法复杂复杂的文件选择需求
人们常说，“选择是放弃的反面”。在选择添加哪些文件到暂存区时，这个哲学观点也同样适用。每一种方法都有其用处，但也有其局限性。选择最合适的方法可以节省你的时间和精力，就像在C++中选择正确的数据结构（如 STL 中的

vector

或

map

）能优化性能。

4.3 代码示例

假设你的C++项目结构如下：

- project/
  - src/
    - main.cpp
    - utility.cpp
  - include/
    - utility.h
  - tests/
    - test_utility.cpp

1. 添加src目录下的所有文件gitadd src/*
2. 添加所有的 .cpp 文件gitadd *.cpp
3. 使用 find 命令添加所有 .cpp 文件，包括子目录find.-name"*.cpp"|xargsgitadd

在添加文件的时候，我们经常要权衡灵活性和精确性。这就像在C++中选择使用指针（Pointer）还是引用（Reference）：一种提供了更多的控制，但也更容易出错；另一种则更安全但也更受限。选择合适的

git add

方法可以让你的开发过程更加高效。

5. 暂存部分更改（Patch Mode）

5.1 什么是Patch Mode

在复杂的编程项目中，尤其是涉及到C/C++这种底层语言时，代码变更通常不是一蹴而就的。你可能需要修改多个文件，甚至一个文件里的多个部分。这时候，Git的

Patch Mode

（补丁模式）就显得极为实用。通过执行

git add -p

命令，你可以逐块（hunk-by-hunk）地审查和暂存代码更改。

就像Knuth（Donald Knuth）在《计算机程序设计艺术》（The Art of Computer Programming）中所说：“程序的优美来自于简单。”在Patch Mode下，你有机会仔细检查每一处修改，确保它们都是有意义和简洁的。

5.1.1 如何使用Patch Mode

执行

git add -p

后，Git会显示代码中不同部分（hunk）的更改，并提供一些选项：

• y: 暂存这个部分
• n: 不暂存这个部分
• s: 将这个部分拆分成更小的部分
• q: 退出

5.2 适用场景和注意事项

Patch Mode特别适用于当你在一个文件中有多个逻辑不相关的更改时。这样，你可以只提交与某个特定任务或Bug修复相关的更改，使得代码历史更加清晰。

编程不仅仅是一种技术活动，它也涉及到一种判断力，一种在无数可能之间做出选择的能力。这个观点也适用于如何使用

git add -p

。暂存逐块更改需要你深入思考每一处代码的意义和影响，这有助于提高代码质量。

5.3 代码示例

假设你有一个C++文件，其中包含两个函数的更改：一个是用于排序的，另一个是用于查找。

// sort function modifiedvoidsort(std::vector<int>& vec){// sorting logic}// search function modifiedintsearch(std::vector<int>& vec,int target){// searching logic}

运行

git add -p

后，你会看到这两个更改被分为两个不同的部分（hunk）。这时，你可以选择只暂存排序函数的更改。

5.4 方法对比

方法适用场景注意事项

git add <file>

当整个文件都需要被暂存时暂存所有更改

git add -u

只暂存已被Git跟踪的文件的更改不会暂存新文件

git add -p

当需要逐块暂存更改时需要人工确认每一块的更改

git add .

当需要暂存所有更改（包括新文件）时会暂存所有更改和新文件

git add --ignore-removal .

当需要暂存新增和修改，但忽略删除时不会暂存被删除的文件
Patch Mode的优点在于它提供了一个更细粒度的控制机制，让你能专注于每一个小改动。这样，你就不会像那些只用

git add .

一把梭的人一样，漏掉重要的细节。这不仅有助于代码审查，也有助于你自己在未来更容易地理解代码的每一个变化。

)第6章：忽略文件权限变化

6.1 为什么文件权限会变？

在Unix-like系统（包括Linux和macOS）中，文件权限（File Permissions）是用于控制谁可以读取、写入或执行文件的一组规则。在C/C++项目中，你可能会遇到需要改变编译输出文件（如可执行文件或库）的权限。或者，你可能会通过脚本自动更改文件权限。

6.1.1 系统级因素

特别是在多用户或多开发者的环境中，文件权限可能因为多种原因而发生变化。如果你在不同的操作系统或使用不同的用户身份进行开发，权限的不一致可能会成为一个问题。

6.1.2 开发过程中的因素

在开发过程中，使用像

chmod

这样的命令去更改文件权限是很常见的。这在某种程度上类似于C++中使用

new

和

delete

操作符来动态分配内存，是一个必要但需要谨慎操作的步骤。

6.2 如何设置Git以忽略权限变化

当你运行

git status

，你可能会注意到一些你从未修改过的文件却因为权限变化而被标记为已修改（Modified）。在这里，我们要介绍的

core.fileMode

配置项就派上用场了。

git config core.fileMode false

这条命令告诉Git忽略文件权限的变化，只关注文件内容的变化。这个设置可以帮助你避免不必要的混乱，特别是当多个开发者或多个环境涉及到同一个项目时。

6.2.1 局部与全局设置

你可以选择只对当前仓库进行这个设置，或者对你的所有仓库进行全局设置。

# 局部设置git config core.fileMode false# 全局设置git config --global core.fileMode false

选择哪种方式取决于你的具体需求和团队规范。

6.2.2 潜在问题

虽然这种方法很方便，但它也有一些潜在的缺点。例如，如果一个文件的执行权限对项目有重要意义，那么忽略权限变化可能会导致问题。

6.3 应用场景和潜在问题

在一个大型的C/C++项目中，你可能需要管理各种各样的文件，包括源代码、头文件、脚本以及其他资源。在这样的复杂环境中，理解和管理文件权限变得尤为重要。

6.3.1 应用场景

比如说，你正在使用CMake来构建你的项目。在生成构建文件或执行测试脚本时，文件权限可能会被改变。这时候，

core.fileMode

设置就可以确保这些无关紧要的变化不会干扰你的Git历史记录。

6.3.2 潜在问题

但是，正如Bjarne Stroustrup在《The C++ Programming Language》中所强调的，每一个便利都有其代价。如果团队中的其他人依赖于特定的文件权限设置，那么忽略这些变化可能会导致一些难以预料的问题。

6.4 技术对比：

git add

与

core.fileMode

方法作用适用场景潜在问题

git add <file>

添加单个文件的所有更改当你需要精确控制哪些文件被添加时可能会不小心添加不需要的文件

git add -u

添加所有已跟踪文件的更改当你想快速更新所有已跟踪文件时不会添加新文件

git config core.fileMode false

忽略文件权限变化多环境或多用户开发可能忽略重要的权限变化
在C/C++开发中，了解并合理使用这些工具能让你的工作更加高效，同时也能帮助你更好地管理复杂的代码库。

6.5 代码示例：如何设置和撤销

core.fileMode

6.5.1 设置

core.fileMode

# 在当前仓库中设置git config core.fileMode false

6.5.2 撤销

core.fileMode

设置

# 在当前仓库中撤销git config --unset core.fileMode

这里的代码示例旨在帮助你快速理解如何在实际项目中应用这些概念。当然，根据你

的具体需求和项目规模，实际应用可能会更为复杂。

)第7章：使用.gitignore文件

7.1 为什么需要.gitignore文件

在C/C++开发中，我们常常会遇到各种临时文件、编译生成的二进制文件或者IDE生成的配置文件。这些文件一般不应该被版本控制，因为它们不是源代码的一部分，而且可能会导致版本库膨胀。正如Bjarne Stroustrup在《The C++ Programming Language》中所说，“简洁是可维护性的先决条件”（Simplicity is prerequisite for reliability）。一个充满垃圾文件的版本库就像一个充满错误的代码库，难以维护和理解。

这时，

.gitignore

文件（Git Ignore）就成了我们的救星。它允许我们指定哪些文件或目录应该被Git忽略。

7.2 基础语法和规则

创建一个名为

.gitignore

的文件在您的Git仓库的根目录。在这个文件里，您可以指定要忽略的文件和目录的模式。

• #：注释
• *：匹配任意多个字符
• ?：匹配任意一个字符
• []：匹配括号内的任意字符
• !：否定，即不忽略

例如，以下是一个典型的C/C++项目的

.gitignore

文件内容：

# 编译生成的文件
*.o
*.so
*.out

# IDE生成的配置文件
.idea/
*.project
*.user

# 系统生成的文件
.DS_Store

注意，您可以在

.gitignore

文件中使用相对路径和绝对路径。

7.3 如何添加或更新.gitignore

添加或更新

.gitignore

文件是非常直接的。您只需编辑该文件，然后使用

git add .gitignore

将其添加到暂存区，最后提交。

但请注意，

.gitignore

只对尚未跟踪的文件有效。如果您之前误将文件添加到了版本库，您需要先用

git rm --cached <filename>

将其从版本库中删除。

7.3.1 特殊情况处理

有时，您可能需要在全局范围内忽略某些文件，而不是仅在单个仓库中。这时，您可以使用全局

.gitignore

文件。运行以下命令来配置：

git config --global core.excludesfile ~/.gitignore_global

然后，在

~/.gitignore_global

文件中添加您想要全局忽略的规则。

7.4 技术与心理学的交汇点

管理一个干净的代码库不仅是一种技术需求，也反映了一种职业素养。有一个著名的心理学名言： “环境即心理”。一个乱七八糟的版本库很容易导致开发者的心态崩溃，类似于一个凌乱的工作环境。通过维护一个清晰、有组织的

.gitignore

文件，不仅可以提升代码质量，还能间接地提升团队的整体心态。

7.5 示例与应用

假设您正在使用CMake进行C++项目开发。通常，CMake会在项目目录中生成一个名为

CMakeFiles/

的目录和一堆

.cmake

和

Makefile

文件。这些都是不应该被版本控制的。

您可以在

.gitignore

文件中添加以下内容：

# CMake生成的文件
CMakeFiles/
CMakeCache.txt
cmake_install.cmake
Makefile

这样，这些文件就会被Git忽略，使您的版本库保持整洁。
方法应用场景注意事项

git add .gitignore

当你首次创建或修改

.gitignore

文件仅适用于尚未被Git追踪的文件

git rm --cached

当你需要从版本库中删除一个已经被追踪的文件这并不会从工作目录中删除文件，只是停止追踪

8. 交互式添加（Interactive Mode）

8.1 理解交互式添加（Interactive Mode）

在程序开发中，尤其是在复杂的C/C++项目中，您可能会面临需要添加多个文件和更改的情况。这时，

git add -i

或

git add --interactive

就成了一种非常有用的工具。它允许您在一个交互式会话中选择性地添加更改。

这个模式有点像在一个大型超市购物，您有一个购物车（暂存区/Staging Area），并且您可以自由地选择哪些商品（文件更改）您要放进购物车。

8.2 功能和选项

8.2.1 主要命令

在交互式添加模式中，您会看到几个主要命令的列表：
命令功能描述

s

状态（Status），查看暂存区和工作区的状态

u

更新（Update），添加已跟踪的文件

a

添加（Add），添加新文件到暂存区

d

丢弃（Discard），从暂存区移除文件

r

恢复（Revert），取消暂存的更改

q

退出（Quit），退出交互式添加模式

8.2.2 示例用法

假设您在一个C++项目中有三个文件被修改：

main.cpp

,

util.cpp

,

config.h

。

gitadd-i

您可以选择

u

来更新（Update）所有已经被跟踪的文件，或者选择

a

来添加（Add）新文件。

8.3 适用场景和注意事项

交互式添加非常适用于大型项目，特别是当您对更改有高度的挑則性时。这就像在玩一个策略游戏，您需要仔细考虑哪一步是最优的。如果你随意添加文件，就像在C++中使用全局变量，可能会导致不可预测的结果。

8.4 从底层原理解析

在C++中，直接操作内存通常会比使用高级抽象更有效。类似地，了解

git add -i

的底层原理也会给您带来更多的灵活性。这个命令实际上是通过修改

.git/index

文件来工作的，该文件包含了所有暂存更改的元数据。

8.5 代码示例

在一个典型的C++项目中，使用交互式添加可能像这样：

# 进入交互式添加模式gitadd-i# 选择 'u' 更新已跟踪的文件> u

# 选择需要更新的文件（例如，1-3 表示选择第1到第3个文件）>1-3

这样，您就可以确保只有真正需要的文件更改被添加到了暂存区。

9. 常见问题与解决方案

在软件开发的旅程中，谁都会遇到一些困扰和疑惑。这并不是因为我们不够聪明或不够努力，而是因为编程就像是一场棋局。每一步都要经过深思熟虑，有时候即便如此，我们仍然可能犯错。在这个环境中，

git add

往往就是我们最容易出错的命令之一。

9.1 如何撤销

git add

假设你已经添加了一些文件到暂存区（Staging Area），但突然意识到这并不是你想要的。在这种情况下，你可能会想知道如何撤销这一操作。这是非常常见的情况，特别是在紧张的项目时间线和多人协作环境中。

9.1.1 使用

git reset

使用

git reset

命令是最直接的方式。这个命令可以用于撤销最后一次的

git add

操作。

git reset

或者，如果你只想撤销特定文件的添加，你可以这样做：

git reset <file_name>

这里，

git reset

像一个时间机器，它可以帮助你回到过去，修正那些本不应发生的事情。

9.1.2 使用

git restore --staged

从Git 2.23版本开始，你也可以使用

git restore

命令来撤销暂存操作。

git restore --staged<file_name>

这个命令更符合人的直觉，就像你正在恢复某个版本的文件。
方法适用场合灵活性

git reset

撤销全部或特定文件的添加中等

git restore --staged

撤销特定文件的添加高

9.2 如何解决冲突

冲突（Conflict）是多人协作环境中不可避免的一部分。当两个不同的分支（Branch）对同一个文件做出不同的更改并试图合并它们时，Git会产生一个冲突。这时，

git add

成为解决冲突的关键步骤。

9.2.1 手动解决冲突

当Git提示你有冲突需要解决时，打开有冲突的文件。你会看到像这样的标记：

<<<<<<< HEAD
// This is your change
=======
// This is the conflicting change from the other branch
>>>>>>> other_branch

你需要手动编辑这些行，删除Git添加的标记，并保留你希望保留的更改。之后，使用

git add

命令来暂存这个解决了冲突的文件。

9.2.2 使用图形界面工具

另一种更直观的方法是使用图形界面工具，例如

git mergetool

。这些工具将以图形界面展示冲突，使其更容易解决。

9.3 常见陷阱与注意事项

在日常使用

git add

时，还有一些细微但重要的注意事项。

9.3.1 谨慎使用

git add .

使用

git add .

将添加当前目录下的所有更改，包括新文件、已修改文件和已删除文件。虽然这很方便，但也很容易不小心添加一些不应该添加的文件。

9.3.2 检查状态

在执行

git add

之前或之后，运行

git status

来确认哪些文件已被添加或修改是一个好习惯。

在C++编程中，我们经常引用Bjarne Stroustrup的观点，即“简单情况应简单，复杂情况应可能”。同样，在使用

git add

时，简单的添加操作应该简单明了，而更复杂的场景，如合并冲突或部分暂存，则应有足够的灵活性来处理。

记住，

git add

不仅仅是一个命令，它是你与代码库互动的方式之一。正如心理学家Carl Rogers所说：“我们不能改变、我们不能移动，我们不能达到我们不先接受的地方。”在软件开发中，这意味着我们需要全面地理解工具和命令，以便更有效地使用它们。

10. 最佳实践 (Best Practices)

在C/C++领域，我们常说，“Always write code as if the guy who ends up maintaining your code will be a violent psychopath who knows where you live,” 这句话由C++编程大师 John Carmack首次提出。这警示我们，编码不仅仅是完成任务，更是一种责任和沟通。这与使用

git add

的最佳实践有异曲同工之妙。

10.1 代码审查前的检查列表 (Pre-Code Review Checklist)

在提交任何更改前，一份全面的检查列表是必不可少的。

• 编译和测试（Compile and Test）: 在C/C++中，没有编译通过的代码是没有价值的。确保你的代码不仅编译通过，而且通过了所有单元测试。
• 代码格式（Code Formatting）: 使用工具如clang-format来自动格式化代码，确保代码风格一致。
• 解决冲突（Resolve Conflicts）: 在执行git add之前，解决所有的merge冲突。
• 局部变量（Local Variables）: 检查是否所有的局部变量都被合理地使用了，避免“未使用变量”这类低级错误。

10.1.1 如何检查你的代码 (How to Inspect Your Code)

使用静态代码分析工具，如

cppcheck

，以自动发现潜在问题。这样，你会更加自信地执行

git add

。

10.2 何时使用哪种添加方法 (When to Use Which Add Method)

选择正确的

git add

方法（方式）是至关重要的。这不仅影响代码的质量，还可能影响团队协作。

• 单个文件（Single File）: 当你只关注一个特定文件的更改时，使用git add <filename>。这是一种保守且聚焦的做法。
• 已修改的文件（Modified Files）: 如果你只想关注已经修改过的文件，而不是新添加的文件，使用git add -u。这是一种更加细粒度的控制。
• 批量添加（Bulk Add）: 在某些情况下，例如初始化一个新项目或添加一个新功能时，git add . 或 git add -A 是合适的。
  方法适用场景注意事项

  git add <filename>
  

  关注单一文件确保不要添加不相关的文件

  git add -u
  

  只添加已经修改过的文件不会添加新文件

  git add .
  

  添加当前目录下所有更改可能会添加不需要的文件

  10.2.1 为何选择细粒度 (Why Granularity Matters)

在微观管理和宏观管理之间找到平衡是艺术与科学的结合。太多的关注细节会让你陷入“分析瘫痪”，而忽视细节则可能导致低质量的代码。当你使用

git add

时，考虑到这一点会让你变得更加高效。

10.3 代码示例 (Code Examples)

让我们通过几个C++代码示例来理解如何在实际应用中运用这些最佳实践。

// Bad practice: Undefined behaviorint arr[10];
arr[10]=0;// Index out of range

在这个例子中，我们试图访问数组的非法索引，这是未定义行为（Undefined Behavior）。在执行

git add

之前，一定要修复这类问题。

// Good practice: Defined behaviorint arr[10];
arr[9]=0;// Last valid index

这里，我们正确地使用了数组的最后一个有效索引。这样的代码更有可能通过代码审查。

通过遵循这些最佳实践，你不仅能写出更好的代码，还能更加自信地使用

git add

来暂存你的更改。毕竟，像Carl Jung所说，“你未意识到的，将会成为你的命运”。所以，更好地了解你的代码和

git add

的工作原理，将会让你更加自信地进行代码提交。

结语

在我们的编程学习之旅中，理解是我们迈向更高层次的重要一步。然而，掌握新技能、新理念，始终需要时间和坚持。从心理学的角度看，学习往往伴随着不断的试错和调整，这就像是我们的大脑在逐渐优化其解决问题的“算法”。

这就是为什么当我们遇到错误，我们应该将其视为学习和进步的机会，而不仅仅是困扰。通过理解和解决这些问题，我们不仅可以修复当前的代码，更可以提升我们的编程能力，防止在未来的项目中犯相同的错误。

我鼓励大家积极参与进来，不断提升自己的编程技术。无论你是初学者还是有经验的开发者，我希望我的博客能对你的学习之路有所帮助。如果你觉得这篇文章有用，不妨点击收藏，或者留下你的评论分享你的见解和经验，也欢迎你对我博客的内容提出建议和问题。每一次的点赞、评论、分享和关注都是对我的最大支持，也是对我持续分享和创作的动力。

---

** 阅读我的CSDN主页,解锁更多精彩内容:泡沫的CSDN主页**