git init 把一个普通目录变成 Git 仓库:它只创建 .git 目录和初始分支引用,不会自动添加任何文件,也不会产生提交。这是从零开始一个项目时的第一条命令。

本文列出 git init 支持的常用参数并逐个解说,覆盖初始分支名、裸仓库、模板、哈希格式等场景,最后给出「初始化 → 首次提交 → 推到远端」的完整流程。

ℹ️
关于本系列
本文是《Git 使用教程》按命令拆分的第 2 / 28 篇,全部收录在 Git 栏目。参数表列的是日常高频项,并非穷举;想看某个命令的完整参数,用 git init -h 看精简列表、git help init 看完整手册。示例以 Git 2.56.0 为准。

一、命令语法

先看语法骨架,再对照下一节的参数表。<占位> 表示必填值,实际输入时不要带尖括号;[...] 表示可选项,-- 用来分隔选项与路径。

bash语法
git init [-q | --quiet] [--bare] [--initial-branch=<name>] [<directory>]

二、参数逐项详解

下表按用途列出 git init 的常用参数,每项都注明了「它到底改变了什么」。

参数作用
<directory>在指定目录创建仓库;不写就把当前目录初始化为仓库
-b <名> / --initial-branch直接指定初始分支名(如 main),免去事后改名;Git 2.28+
--bare建裸仓库,没有工作区,通常放在服务器上做共享仓库
--template=<目录>用自定义模板初始化 .git/,可预置钩子、默认配置与忽略规则
--separate-git-dir=<路径>把 .git 放到别处,工作目录只留一个指向它的链接文件
--object-format=<格式>指定对象哈希格式:sha1(默认)或 sha256(实验性)
--ref-format=<格式>引用存储格式:files(默认)或 reftable
-q / --quiet只报错误,不打印提示信息
--shared[=<权限>]设置仓库的组权限,供多人共享同一裸仓库时使用

三、常用示例

最常用:指定初始分支名

bash最常用:指定初始分支名
mkdir my-project && cd my-project
git init -b main
git status -sb          # ## No commits yet on main

完整流程:从空目录到远端

bash完整流程:从空目录到远端
echo "# my-project" > README.md
git add -A
git commit -m "chore: 初始化项目"
git remote add origin git@example.com:team/my-project.git
git push -u origin main

建一个服务端裸仓库

bash建一个服务端裸仓库
git init --bare /srv/git/team-project.git
# 之后客户端 git clone user@host:/srv/git/team-project.git

四、注意事项

⚠️
init 不会替你 add 和 commit
git init 之后文件全是「未跟踪」状态,必须自己 git add + git commit 才有第一个提交。另外在已有仓库里再跑一次 git init 通常是安全的(会重新初始化配置),但别把它当成「清空仓库」的手段。
忘了 -b 怎么办: 用 git branch -m master main 重命名当前分支,或提前配 git config --global init.defaultBranch main,以后所有新仓库都自动用 main。

五、小结

日常只需要记住 git init -b main;--bare 只在搭服务端仓库时出现,--template、--object-format 属于团队规范化与环境定制。真正决定项目起点的,其实是紧随其后的 .gitignore 与第一次提交。

本系列共 28 篇,一个命令一篇,完整目录见 Git 栏目。下一篇:git clone 命令参数详解。