git init 命令

简介

git init 是 Git 中用于初始化新仓库的命令。它会在当前目录创建一个新的 Git 仓库，开始版本控制。

基本概念

什么是初始化

初始化是在目录中创建 .git 子目录的过程，这个目录包含 Git 仓库的所有元数据和对象数据库。

初始化的作用

1. 创建 Git 仓库结构
2. 初始化配置
3. 创建初始分支（通常是 main 或 master）
4. 准备开始版本控制

命令语法

# 在当前目录初始化
git init

# 在指定目录初始化
git init <目录名>

# 初始化裸仓库
git init --bare

查看帮助文档

$ git init --help

常用选项

选项	说明
--bare	创建裸仓库（无工作目录）
--template=<模板目录>	使用指定的模板目录
--separate-git-dir=<git目录>	将 .git 目录放在指定位置
-q, --quiet	静默模式
--initial-branch=<分支名>	设置初始分支名（默认 main）
--shared[=<权限>]	设置仓库为共享仓库

基本使用

1. 基本初始化

# 在当前目录初始化
$ git init

# 在指定目录初始化
$ git init my-project

2. 初始化裸仓库

# 创建裸仓库（用于服务器）
$ git init --bare repo.git

# 裸仓库没有工作目录，只用于共享

3. 设置初始分支名

# 设置初始分支为 main
$ git init --initial-branch=main

# 或使用配置
$ git config --global init.defaultBranch main
$ git init

4. 使用模板

# 使用模板初始化
$ git init --template=/path/to/template

5. 分离 Git 目录

# 将 .git 目录放在其他位置
$ git init --separate-git-dir=/path/to/git-dir

实际应用场景

场景1：初始化新项目

# 创建项目目录
$ mkdir my-project
$ cd my-project

# 初始化 Git 仓库
$ git init

# 添加文件
$ echo "# My Project" > README.md
$ git add README.md
$ git commit -m "Initial commit"

场景2：将现有项目纳入版本控制

# 进入项目目录
$ cd existing-project

# 初始化 Git
$ git init

# 添加所有文件
$ git add .

# 提交
$ git commit -m "Initial commit"

场景3：创建共享仓库

# 创建裸仓库用于共享
$ git init --bare shared-repo.git

# 其他人可以克隆
$ git clone /path/to/shared-repo.git

场景4：设置初始分支

# 使用 main 作为初始分支
$ git init --initial-branch=main

# 或配置全局默认
$ git config --global init.defaultBranch main

初始化后的操作

1. 配置用户信息

# 设置用户名和邮箱
$ git config user.name "Your Name"
$ git config user.email "your.email@example.com"

# 或全局配置
$ git config --global user.name "Your Name"
$ git config --global user.email "your.email@example.com"

2. 添加远程仓库

# 添加远程仓库
$ git remote add origin https://github.com/user/repo.git

# 查看远程
$ git remote -v

3. 创建初始提交

# 添加文件
$ git add .

# 创建初始提交
$ git commit -m "Initial commit"

4. 推送到远程

# 推送到远程
$ git push -u origin main

常见问题和解决方案

问题1：已经存在 .git 目录

解决方案：

# 检查是否已初始化
$ ls -la .git

# 如果已存在，不需要再次初始化

问题2：想重新初始化

解决方案：

# 删除 .git 目录（谨慎！）
$ rm -rf .git

# 重新初始化
$ git init

问题3：初始分支名不是想要的

解决方案：

# 初始化时指定
$ git init --initial-branch=main

# 或配置全局默认
$ git config --global init.defaultBranch main

最佳实践

1. 初始化后立即配置

# 初始化
$ git init

# 配置用户信息
$ git config user.name "Your Name"
$ git config user.email "your.email@example.com"

# 创建 .gitignore
$ echo "node_modules/" > .gitignore

2. 创建初始提交

# 初始化后创建初始提交
$ git add .
$ git commit -m "Initial commit"

3. 设置默认分支名

# 配置全局默认分支为 main
$ git config --global init.defaultBranch main

4. 使用 .gitignore

# 初始化后创建 .gitignore
$ cat > .gitignore << EOF
node_modules/
*.log
.DS_Store
EOF

总结

git init 是开始使用 Git 的第一步：

1. 基本用法：git init 初始化当前目录
2. 裸仓库：git init --bare 创建共享仓库
3. 初始分支：--initial-branch 设置初始分支名
4. 后续操作：配置用户信息、添加远程、创建初始提交

关键要点：

• ✅ 初始化后配置用户信息
• ✅ 创建 .gitignore 文件
• ✅ 创建初始提交
• ✅ 设置默认分支名（main）