什么是 git init 命令？从零开始理解版本控制的起点
你有没有遇到过这样的场景：写了一整天的代码，结果不小心删错了文件，或者改得面目全非，想找回之前的版本却无从下手？这时候，一个强大的工具——Git，就能救你于水火之中。
而所有这一切的起点，就是 git init 命令。它就像你给一个新项目“安家落户”的第一步。当你运行这个命令时，Git 会在当前目录下创建一个隐藏的 .git 文件夹，这个文件夹就是整个项目版本控制系统的“大脑”。它记录了你所有提交的历史、分支信息、配置选项，甚至还有文件快照的索引。
想象一下，你正在建造一座房子。在正式动工前，你需要先打地基、规划图纸。git init 就是这个“打地基”的动作。没有它，你无法使用 Git 的任何功能，就像没有图纸的房子，根本没法施工。
💡 提示：
git init命令只能在本地项目目录中运行。如果你在空文件夹里运行它，Git 会为你创建一个全新的版本控制仓库。
如何使用 git init 命令？一步一步实操指南
我们来亲手体验一次 git init 命令的实际操作。
假设你正在开发一个简单的“待办事项”应用，项目名为 todo-app。首先，创建项目目录并进入：
mkdir todo-app
cd todo-app
现在，运行 git init 命令：
git init
执行后，你会看到类似这样的输出：
Initialized empty Git repository in /path/to/todo-app/.git/
这说明 Git 已经成功初始化，一个名为 .git 的隐藏文件夹已经生成。
📌 注意：
.git文件夹是 Git 的核心，不要手动修改或删除它，否则整个版本控制体系将失效。
你可以通过以下命令查看该文件夹内容（在 macOS 或 Linux 系统中）：
ls -la
你会看到一个名为 .git 的目录，里面包含 objects、refs、config、HEAD 等子文件夹和文件。这些就是 Git 存储所有版本信息的地方。
git init 命令的底层原理：Git 是如何“记住”你的代码的？
很多人以为 Git 只是“保存代码”，其实它更像一个“时间机器”。每一次提交，Git 都会创建一个唯一的“快照”，并用一个哈希值（SHA-1）作为标识。
举个例子，当你第一次运行 git init 后，Git 会创建一个默认的 HEAD 指针，指向一个空的提交（commit）。这个提交是“空的”，因为还没有文件被添加。
这时你添加一个文件，比如 index.html：
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<title>待办事项</title>
</head>
<body>
<h1>我的待办清单</h1>
<ul id="task-list"></ul>
</body>
</html>
然后使用 Git 的三个基本状态：工作区（Working Directory）、暂存区（Staging Area） 和 版本库（Repository）。
- 文件在工作区中（你刚写的 HTML）
- 用
git add把它放入暂存区 - 用
git commit将暂存区的内容提交到版本库
这三步是 Git 的核心流程。git init 只是第一步，它为后续的 add 和 commit 打好了基础。
常见的 git init 使用场景与技巧
创建带说明的初始化仓库
有时候你希望初始化时就设置一些默认信息，比如作者名和邮箱。你可以提前配置：
git config --global user.name "张三"
git config --global user.email "zhangsan@example.com"
这样，后续的提交会自动带上你的身份信息。注意：--global 表示全局配置，适用于你所有的项目。
初始化非空目录
如果你已经有一些代码文件，想把它变成 Git 仓库，也可以直接运行 git init。它不会清空你现有的文件，只是开始追踪它们。
比如你有一个 src/ 文件夹和 README.md 文件：
git init
git add .
git commit -m "初始化项目：添加源码和文档"
这三行命令就完成了从“普通文件夹”到“可追踪项目”的转变。
避免初始化错误：常见问题排查
-
❌ 错误：在已有 Git 仓库中再次运行
git init
结果：Git 会提示你“fatal: not a git repository”，因为.git已存在。 -
✅ 正确做法：进入项目目录，确认是否已有
.git文件夹。如果有，就不要再执行git init。 -
❌ 错误：在根目录外运行
git init
结果：虽然不会报错，但会在错误位置创建仓库。 -
✅ 正确做法：始终在你要管理的项目根目录下运行命令。
git init 与其他 Git 命令的配合使用
git init 不是孤立存在的。它是整个 Git 工作流的起点。接下来我们看看它如何与其他命令联动。
1. 初始化后立即添加文件
git init
git add index.html
git commit -m "添加首页文件"
这四步是新手最常用的流程。add 命令把文件“暂存”起来，commit 才真正保存版本。
2. 查看仓库状态
运行 git status 可以查看当前工作区的状态：
git status
输出示例：
On branch main
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
index.html
nothing added to commit but untracked files present (use "git add" to track)
这个提示告诉你：index.html 是“未跟踪”的文件，需要 git add 才能被 Git 记录。
3. 用 .gitignore 忽略不需要追踪的文件
项目中常有一些临时文件，比如日志、缓存、编译产物等，不需要提交到版本库。这时可以用 .gitignore 文件。
创建 .gitignore 文件：
echo "node_modules/" > .gitignore
echo ".env" >> .gitignore
echo "*.log" >> .gitignore
然后再次运行 git status，你会发现这些文件不再出现在“未跟踪”列表中。
实战案例：从零搭建一个 Vue 3.0 项目并初始化 Git
让我们来一个完整的实战演练。假设你要用 Vue 3.0 搭建一个前端项目，并希望用 Git 进行版本管理。
步骤 1：创建项目目录并初始化 Git
mkdir my-vue-app
cd my-vue-app
git init
步骤 2：初始化 Vue 项目
使用 Vue CLI 创建项目：
npm create vue@latest
按照提示选择默认配置即可。这会自动安装依赖并生成项目结构。
步骤 3：添加所有文件并提交
git add .
git commit -m "初始化 Vue 3.0 项目结构"
现在，你的整个项目已经纳入 Git 管理。
步骤 4：查看提交历史
git log --oneline
你会看到类似这样的输出：
a1b2c3d 初始化 Vue 3.0 项目结构
这个哈希值 a1b2c3d 就是这次提交的唯一标识，你可以用它来恢复某个版本。
总结：掌握 git init 命令，就是掌握版本控制的钥匙
git init 命令虽然简单，却是所有 Git 操作的起点。它不仅创建了版本控制的“容器”，还为你后续的代码管理打下了坚实基础。
记住几个关键点：
- 每个项目只需运行一次
git init - 它会创建
.git隐藏文件夹，切勿手动删除 - 初始化后，配合
add、commit才能真正开始版本管理 - 项目结构清晰、合理使用
.gitignore，是良好开发习惯的体现
无论你是初学者，还是已有经验的开发者，只要开始写代码，就一定会用到 git init 命令。它是你从“随意写代码”走向“规范开发”的第一道门槛。
从今天起，养成在项目创建之初就运行 git init 的习惯。它不只是一行命令，更是一种专业态度的体现。