git init 教程

一句话理解

git init 会在当前目录下创建一个新的 Git 仓库元数据结构，让这个目录开始具备版本管理能力。

最常见场景

• 新项目从零开始接入 Git
• 已有代码目录想纳入版本管理
• 临时实验目录需要快速建立本地仓库

基本用法

git init

执行后会生成 .git 目录，其中保存对象数据库、引用和配置。

指定默认分支

git init -b main

如果你想明确初始化后的主分支名称，这种写法更直接。

一个常见工作流

git init
git add .
git commit -m "chore: initial commit"

常见误区

误区 1：init 会自动产生首个提交

不会。git init 只是初始化仓库，真正的历史起点来自你的第一次 commit。

误区 2：已有目录不能再 init

可以。对已有项目执行 git init 很常见，只要你清楚它会把当前目录作为一个新仓库开始管理。

这条命令在流程里解决什么问题

git init 更偏向仓库初始化、配置和使用方式本身。它不一定天天出现，但会决定你之后的大部分 Git 行为是否稳定、可预期。

典型用例

• 在干净目录中快速创建新仓库，开始项目开发。
• 把 git init 放进 onboarding 和环境检查流程，减少“每个人本地行为不一致”的问题。
• 在排查 Git 行为差异时，用 git init 在一个干净目录中快速创建对照仓库，排除旧配置干扰。

图例理解

基础条件

仓库目录配置层级帮助主题

→git init

结果

初始化状态生效配置可参考文档

这类命令的价值往往不在“立即生成提交”，而在于让后面的所有命令更稳定可预测。

特殊情况与边界

• 配置和初始化类命令往往不会立刻造成事故，但一旦默认值错了，后面很多命令都会持续偏离预期。
• 如果你在团队环境里使用 git init，最好把关键默认配置写成文档或脚本，而不是只靠个人记忆。
• 当行为和文档不一致时，先排查配置层级、别名和本地环境差异。