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 命令参数详解。