版本控制与协作 / 系统课时

初始化本地仓库

初始化本地仓库

学习目标

完成本课后,你将能够:

  • 使用 git init 创建本地仓库
  • 识别 .git 元数据目录
  • 判断当前位置是否属于 Git 工作树

核心原理

git init 不会自动提交现有文件,也不会把项目上传到远程平台;它只是在当前目录创建或重新初始化 .git。工作区是项目文件所在目录,.git 是版本库元数据。多数情况下一个工作区对应一个 .git,子目录会继承上层仓库边界。

再次执行 git init 通常不会清空历史,而是重新初始化现有仓库。真正删除 .git 会使目录失去全部本地版本历史、分支和配置,因此不能把它当作可随意重建的普通目录。

基础用法

进入目标项目根目录后运行 git init。随后使用 git status 检查仓库状态,使用 git rev-parse --is-inside-work-tree 判断是否位于工作树中,使用 git rev-parse --git-dir 查看 Git 元数据目录。隐藏目录默认可能不显示,需要使用 ls -la。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。

bash
rm -rf git-init-demo
mkdir git-init-demo
cd git-init-demo
git init
printf "inside work tree: "
git rev-parse --is-inside-work-tree
printf "git directory: "
git rev-parse --git-dir
printf "metadata exists: "
test -d .git && echo yes

预期输出

text
Initialized empty Git repository in <REPOSITORY_PATH>/.git/
inside work tree: true
git directory: .git
metadata exists: yes

Tips

  • 初始化前确认目录是项目根目录,而不是用户主目录。
  • 不要手工编辑 .git 内部文件,除非明确理解对象和引用格式。
  • 已有项目加入 Git 时,先创建 .gitignore 再批量暂存。

常见错误

1. 初始化在上级目录

  • 错误表现:多个项目被意外视为同一仓库。
  • 正确处理:通过 git rev-parse --show-toplevel 找到仓库根目录,再决定是否移除错误的 .git。

2. 认为 init 会创建远程仓库

  • 错误表现:初始化后在 GitHub 或 GitLab 看不到项目。
  • 正确处理:本地初始化与远程创建是独立步骤,后续还需添加远程地址并推送。

本课练习

1. 初始化空仓库

  • 任务目标:初始化空仓库。
  • 输入或初始条件:创建一个空目录。
  • 实现要求:执行初始化并查看 .git。
  • 验收条件:git status 不再提示非仓库错误。

2. 识别仓库根目录

  • 任务目标:识别仓库根目录。
  • 输入或初始条件:在仓库内创建两级子目录。
  • 实现要求:从最深目录运行根目录查询命令。
  • 验收条件:输出仍指向外层项目根目录。

3. 验证重复初始化

  • 任务目标:验证重复初始化。
  • 输入或初始条件:在同一仓库内保留一个文件。
  • 实现要求:再次执行 git init。
  • 验收条件:文件未丢失,仓库仍可正常使用。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

初始化本地仓库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通