---

Git 初始化教程：创建你的第一个仓库

欢迎来到版本控制的世界！如果你正在学习 Git，那么创建一个新的仓库（Repository，简称 Repo）是你踏上这段旅程的第一步。这个过程被称为“初始化”。初始化一个 Git 仓库，就像是告诉 Git：“嘿，请开始跟踪这个文件夹里的所有文件和未来的变化吧！”

本文将带你一步一步地完成 Git 仓库的初始化过程。我们将深入探讨 git init 命令的作用，它背后发生了什么，以及在初始化之后，你通常需要做的几件重要事情。无论你是在一个全新的、空荡荡的文件夹里开始一个项目，还是想把你已有的项目纳入 Git 的管理，本教程都将为你提供详细的指导。

我们的目标是让你不仅学会如何输入命令，更能理解其原理，为你未来的 Git 使用打下坚实的基础。

前置准备：确保你已经安装了 Git

在开始之前，请确保你的计算机上已经安装了 Git。如果你还没有安装，可以访问 Git 官方网站 (https://git-scm.com/downloads) 下载适合你操作系统的版本并进行安装。

安装完成后，打开你的终端（macOS/Linux）或命令提示符/PowerShell（Windows），输入以下命令来验证 Git 是否安装成功并查看其版本：

bash
git --version

如果显示了 Git 的版本信息，说明你已经准备好了！

理解“仓库”（Repository）和“初始化”（Initialization）

在 Git 的世界里，“仓库”（Repository）是你的项目版本历史、元数据和配置文件的集合。它包含了你项目的所有文件在不同时间点的快照。你可以把一个 Git 仓库想象成一个非常智能的项目文件夹，它不仅存储了你的文件，还记录了这些文件的每一次重要变动。

而“初始化”（Initialization）就是将一个普通的文件夹变成这样一个“智能”的 Git 仓库的过程。这个过程的核心就是创建一个特殊的子目录，叫做 .git。

.git 目录：仓库的大脑

当你运行 git init 命令时，Git 会在你指定的文件夹中创建一个名为 .git 的隐藏子目录。这个 .git 目录是 Git 仓库的核心和大脑。它包含了 Git 管理项目所需的一切信息，包括：

• 对象数据库 (objects): 这是存储你的所有版本历史、提交记录、文件内容、目录结构等“对象”的地方。Git 通过一种高效的方式存储这些对象，避免重复存储相同内容的文件。
• 索引 (index): 也被称为“暂存区”（Staging Area）。这是一个非常重要的概念，它是一个文件，记录了下一次提交时将要包含哪些文件和哪些内容的快照。
• HEAD: 一个指向当前分支或提交的指针。它告诉 Git 你目前工作在哪个版本上。
• 配置 (config): 仓库特定的配置文件，包含了该仓库的各种设置，例如远程仓库地址、合并策略等。
• 引用 (refs): 存储指向提交的各种引用，比如分支（branches）和标签（tags）。
• 钩子 (hooks): 客户端或服务器端脚本，可以在 Git 操作的特定时刻自动执行（例如，在提交前检查代码格式）。
• 描述 (description): 主要用于 GitWeb 程序。

.git 目录是 Git 工作的幕后英雄。永远不要手动去修改或删除 .git 目录中的内容，除非你完全清楚自己在做什么，否则可能会破坏你的仓库！

两种初始化场景

通常，你会遇到两种主要的初始化场景：

1. 在一个全新的、空荡荡的文件夹中创建一个新的 Git 仓库。 这是从零开始一个新项目时最常见的情况。
2. 在一个已经包含项目文件的现有文件夹中初始化一个 Git 仓库。 这是当你决定将一个已有的项目纳入版本控制时所做的。

我们将分别详细介绍这两种场景。

场景一：在一个全新的空文件夹中初始化 Git 仓库

这是最简单、最直观的初始化方式。假设你想创建一个名为 my_first_git_repo 的新项目。

步骤 1：创建项目文件夹

首先，你需要创建一个用于存放你项目的文件夹。你可以使用文件管理器手动创建，或者在终端中使用 mkdir 命令。

打开你的终端，并导航到你想要创建项目的目录（例如，你的文档目录、桌面等）。然后执行以下命令来创建文件夹：

bash
mkdir my_first_git_repo

这条命令会在当前目录下创建一个名为 my_first_git_repo 的新文件夹。

步骤 2：进入项目文件夹

接下来，你需要进入刚刚创建的文件夹。使用 cd 命令（change directory）：

bash
cd my_first_git_repo

现在，你的终端就定位在了这个新的空文件夹中。

步骤 3：执行 Git 初始化命令

在你希望变成 Git 仓库的文件夹内，运行神奇的 git init 命令：

bash
git init

理解 git init 的输出

当你运行 git init 后，终端会显示类似如下的信息：

Initialized empty Git repository in /path/to/your/directory/my_first_git_repo/.git/

这行输出非常重要。它告诉我们：

• Git 已经成功地在这个目录下初始化了一个仓库。
• 它创建了一个 .git 目录，并显示了 .git 目录的完整路径。
• 关键字 “empty” 表明这是一个空的 Git 仓库，因为你在一个空文件夹中执行了初始化。

步骤 4：确认 .git 目录已创建

要确认 .git 目录确实存在，你可以在终端中列出当前目录下的所有文件，包括隐藏文件。

• 在 macOS/Linux 上，使用 ls -a 命令：

  bash
ls -a
  你会看到 .git 目录出现在列表中（以及可能存在的 . 和 ..）。

• 在 Windows 的命令提示符或 PowerShell 中，使用 dir /A 命令：

  cmd
dir /A
  或者在 PowerShell 中使用 Get-ChildItem -Force：
  powershell
Get-ChildItem -Force
  你应该会看到 .git 目录被列出。

如果你能看到 .git 目录，恭喜你！你已经成功地在一个空文件夹中创建了你的第一个 Git 仓库。

初始化之后：下一步做什么？

一个空的 Git 仓库本身并没有太大用处。它的目的是用来跟踪你的项目文件。初始化完成后，你的下一步通常是：

1. 创建或复制项目文件到这个文件夹中。
2. 将这些文件添加到 Git 的跟踪列表（暂存区）中，使用 git add 命令。
3. 将暂存区中的文件快照提交到仓库的历史记录中，使用 git commit 命令。

我们将在后面的章节详细介绍 git add 和 git commit，因为它们是紧跟 git init 之后最常用的操作。

场景二：在一个已经包含项目文件的现有文件夹中初始化 Git 仓库

假设你已经有一个项目，它可能包含代码、文档、图片等文件，并且你现在决定要使用 Git 来管理它的版本。这个过程与场景一非常相似，只是你跳过了创建空文件夹的步骤。

步骤 1：导航到你的项目文件夹

打开你的终端，并使用 cd 命令导航到你现有项目的根目录。这个根目录是指包含你项目所有文件和子文件夹的那个主文件夹。

例如，如果你的项目在 ~/Documents/MyExistingProject：

bash
cd ~/Documents/MyExistingProject

步骤 2：执行 Git 初始化命令

确保你位于项目的主目录内，然后运行 git init 命令：

bash
git init

理解 git init 的输出 (在现有目录中)

在现有目录中运行 git init，输出信息可能与在空目录中略有不同，但核心信息是一样的：

Initialized empty Git repository in /path/to/your/existing/project/.git/

你可能会注意到它仍然说 “Initialized empty Git repository”。这听起来有点奇怪，因为它里面明明有文件啊？这里的 “empty” 指的是 Git 的对象数据库（.git/objects）在初始化时是空的。Git 本身还没有开始跟踪你现有的文件。它只是创建了管理这些文件所需的基础结构（.git 目录）。

步骤 3：确认 .git 目录已创建

同样，使用 ls -a (macOS/Linux) 或 dir /A / Get-ChildItem -Force (Windows) 来确认 .git 目录已经成功创建在你项目的根目录中。

初始化之后 (在现有目录中)：将现有文件添加到仓库

这是在现有项目中初始化后与在空项目中初始化后最大的区别。你的项目文件夹里已经有很多文件了，你需要告诉 Git 开始跟踪它们并将它们作为项目的第一个版本保存下来。

1. 检查文件状态：git status
   运行 git status 命令。你会看到 Git 列出了你项目中的所有文件，并将它们标记为 “Untracked files” (未被跟踪的文件)。

   bash
git status

   输出可能类似这样：

   “`
   On branch master

   No commits yet

   Untracked files:
   (use “git add …” to include in what will be committed)
   file1.txt
   src/main.py
   docs/README.md
   images/logo.png
   … (your project files)

   nothing added to commit but untracked files present (use “git add” to track)
   “`
   这清楚地表明 Git 知道这些文件存在，但还没有将它们纳入版本控制。

2. 将文件添加到暂存区：git add
   现在，你需要告诉 Git 你想跟踪哪些文件。对于一个现有项目，你通常会想跟踪所有重要的项目文件。你可以逐个添加文件，或者使用通配符。最常见的是添加当前目录下所有文件和文件夹（除了那些你指定忽略的）：

   bash
git add .
   这个命令会将当前目录（.）下的所有未被忽略的文件和子目录添加到 Git 的“暂存区”（Staging Area）。

   再次运行 git status 来看看变化：

   bash
git status

   这次，输出会显示这些文件已经被移到了 “Changes to be committed” (将要被提交的更改) 部分，并且是 “new file:” (新文件)：

   “`bash
   On branch master

   No commits yet

   Changes to be committed:
   (use “git rm –cached …” to unstage)
   new file: file1.txt
   new file: src/main.py
   new file: docs/README.md
   new file: images/logo.png
   …

   “`
   这表示这些文件已经准备好被提交到仓库的历史记录中了。

3. 提交文件：git commit
   最后一步是将暂存区中的文件快照正式保存为仓库历史中的第一个提交。每个提交都需要一个提交信息（Commit Message），用来描述这次提交做了什么。对于第一次提交，一个常见的提交信息是 “Initial commit” 或 “First commit”。

   使用 git commit 命令，并使用 -m 标志后跟你的提交信息：

   bash
git commit -m "Initial commit of the project"

   Git 会输出关于这次提交的信息，例如创建的文件数量、插入/删除的行数等：

   bash
[master (root-commit) 1234567] Initial commit of the project
4 files changed, 87 insertions(+)
create mode 100644 file1.txt
create mode 100644 src/main.py
create mode 100644 docs/README.md
create mode 100644 images/logo.png
   这里的 1234567 是这次提交的短哈希值，用于唯一标识这次提交。(root-commit) 表示这是这个仓库的第一个提交。

   现在，再次运行 git status：

   bash
git status

   输出会显示：

   bash
On branch master
nothing to commit, working tree clean
   这意味着你的工作目录是干净的，所有重要的文件都已经被 Git 跟踪并记录在了仓库的历史中。恭喜！你已经成功地将一个现有项目纳入了 Git 的管理，并创建了它的第一个提交。

理解 Git 的工作区域：工作目录、暂存区和仓库

在初始化和提交的过程中，我们提到了几个重要的区域。理解它们之间的关系对于理解 Git 如何工作至关重要：

1. 工作目录 (Working Directory): 这就是你实际进行文件操作的文件夹。你在这里创建、修改、删除文件。这是你直接看到和操作的文件。
2. 暂存区 (Staging Area / Index): 这是 Git 提供的一个中间区域。当你使用 git add 命令时，你就是将工作目录中的文件快照添加到了暂存区。暂存区的内容代表了你下一次提交将要包含的内容。它允许你精心准备和审查即将提交的更改，而不是一股脑地提交所有修改。
3. 本地仓库 (Local Repository): 这就是 .git 目录。它存储了你的项目的完整版本历史、提交记录和所有元数据。当你使用 git commit 命令时，Git 会将暂存区中的快照永久地记录到本地仓库中，形成一个新的提交。

你的典型工作流程将是：

修改工作目录中的文件 -> git add 将修改添加到暂存区 -> git commit 将暂存区的内容提交到本地仓库。

额外的初始化后配置和最佳实践

在初始化你的第一个 Git 仓库并创建第一个提交后，有一些额外的配置和最佳实践值得你立即关注：

1. 配置你的用户信息 (全局或局部)

Git 在每次提交时都会记录提交者的姓名和电子邮件地址。这些信息非常重要，因为它们被嵌入到每次提交中，用于追溯是谁做了哪些更改。

你可以在全局范围（适用于你计算机上的所有 Git 仓库）或局部范围（仅适用于当前仓库）配置这些信息。通常，全局配置更方便。

打开终端，运行以下命令（请将示例信息替换为你自己的）：

全局配置 (推荐):

bash
git config --global user.name "Your Name"
git config --global user.email "[email protected]"
使用 --global 标志意味着这些设置将被保存在你的用户主目录下的 .gitconfig 文件中，并应用于你今后在你计算机上进行的所有 Git 操作。

局部配置 (仅当前仓库):

如果你想为某个特定仓库使用不同的姓名或邮箱，可以在该仓库的根目录内运行命令，但不使用 --global 标志：

bash
git config user.name "Project Specific Name"
git config user.email "[email protected]"
这会将配置保存在当前仓库的 .git/config 文件中，并覆盖全局设置（如果存在）。

检查配置：

你可以使用以下命令查看你的 Git 配置信息：

bash
git config --global --list # 查看全局配置
git config --local --list # 查看当前仓库配置 (需在仓库目录内运行)
git config --list # 查看所有配置 (全局、系统、本地)

2. 创建 .gitignore 文件

很多项目中会包含一些不应该被 Git 跟踪的文件或目录。例如：

• 编译生成的文件（如 .class 文件, build/ 目录）
• 日志文件（如 *.log）
• 依赖管理工具下载的包（如 node_modules/ 目录）
• 操作系统生成的文件（如 .DS_Store, Thumbs.db）
• 敏感信息文件（如配置文件中的密码）

将这些文件添加到 Git 仓库会使仓库变得臃肿，增加不必要的提交，甚至引入安全风险。 .gitignore 文件就是用来告诉 Git 哪些文件或目录应该被忽略，不被跟踪。

创建 .gitignore 文件：

在你的 Git 仓库的根目录下，创建一个名为 .gitignore 的新文件（注意文件名以点开头）。

“`bash

在终端创建并编辑文件 (使用你喜欢的编辑器, 例如 nano, vim, code)

例如使用 nano:

nano .gitignore
“`

在 .gitignore 文件中，每一行指定一个忽略规则。你可以使用通配符。

.gitignore 文件示例：

“`gitignore

忽略所有 .log 文件

*.log

忽略 build 目录

build/

忽略 node_modules 目录

node_modules/

忽略特定文件

my_config.json

忽略操作系统生成的隐藏文件

.DS_Store
Thumbs.db

以斜杠开头表示只忽略当前目录下的文件或目录

/temp/

以斜杠结尾表示只忽略目录

data/
“`

保存并关闭 .gitignore 文件后，它本身是一个重要的项目文件，因为它定义了版本控制的规则。因此，你应该将 .gitignore 文件本身添加到 Git 并提交它：

bash
git add .gitignore
git commit -m "Add .gitignore file"

重要提示： .gitignore 只会忽略未被跟踪的文件。如果你不小心已经将某个文件提交到了仓库中，然后才将其添加到 .gitignore，Git 不会自动停止跟踪它。你需要先使用 git rm --cached <file> 命令将其从仓库中移除（保留工作目录中的文件），然后再提交。

3. 理解主分支名称 (master 或 main)

在早期的 Git 版本中，初始化仓库时创建的默认分支通常被命名为 master。近年来，为了更具包容性，许多 Git 服务提供商（如 GitHub, GitLab, Bitbucket）和 Git 社区倾向于使用 main 作为默认分支名称。

当你运行 git init 时，它会根据你的 Git 版本和配置来决定默认分支的名称。较新的 Git 版本（2.28+）允许配置默认分支名称。

如果你想在初始化时指定默认分支名称，可以使用 --initial-branch 参数：

bash
git init --initial-branch=main

或者，你可以在全局 Git 配置中设置默认分支名称：

bash
git config --global init.defaultBranch main
设置了这个全局配置后，以后你执行 git init 时就会默认使用 main 作为初始分支名称，而不再需要 --initial-branch 参数。

无论你的初始分支是 master 还是 main，它都是你的项目的主线开发分支。理解当前所在的分支非常重要，git status 命令会告诉你当前所在的分支 (On branch master 或 On branch main)。

总结：初始化是起点

git init 命令是你在一个新项目或现有项目中开始使用 Git 的第一步。它简单而强大，通过在指定目录中创建 .git 隐藏文件夹，将一个普通目录转变为一个功能齐全的 Git 仓库。

初始化后，紧接着的步骤是将你的项目文件添加到 Git 的跟踪中 (git add) 并创建你的第一个提交 (git commit)。同时，配置你的用户信息和设置 .gitignore 文件是良好的实践，可以帮助你更好地管理你的仓库。

回顾核心命令：

• mkdir [目录名]: 创建一个新的文件夹。
• cd [目录路径]: 切换到指定的文件夹。
• git init: 在当前文件夹中初始化一个新的 Git 仓库。
• ls -a (macOS/Linux) / dir /A 或 Get-ChildItem -Force (Windows): 列出包含隐藏文件在内的所有文件和目录，用于确认 .git 目录的存在。
• git status: 查看工作目录和暂存区中文件的当前状态（未跟踪、已修改、已暂存等）。
• git add [文件名] 或 git add .: 将文件或当前目录下的所有文件添加到暂存区。
• git commit -m "[提交信息]": 将暂存区的内容提交到本地仓库，创建一个新的版本记录。
• git config --global user.name "Your Name": 设置全局用户姓名。
• git config --global user.email "[email protected]": 设置全局用户邮箱。

初始化一个仓库仅仅是 Git 旅程的开始。一旦你的仓库创建并有了第一个提交，你就可以开始享受 Git 带来的强大版本控制功能了：跟踪文件更改、回溯历史版本、创建分支进行并行开发、与团队成员协作等等。

花时间实践本教程中的步骤，亲手在你的电脑上初始化几个仓库，创建文件，进行添加和提交操作。通过反复练习，你将对这些基础概念和命令越来越熟悉。

恭喜你迈出了使用 Git 的第一步！现在，你已经准备好开始更深入地探索 Git 的世界，例如如何修改文件并提交新的更改，如何查看提交历史，如何创建和切换分支，以及如何与远程仓库（如 GitHub, GitLab）进行交互。祝你学习愉快！