创建与克隆仓库

# 在当前目录创建 Git 仓库
git init

# 在指定目录创建 Git 仓库（目录不存在会自动创建）
git init /path/to/project

# 创建裸仓库（无工作区，通常用于服务器端）
git init --bare /path/to/repo.git

$ git init my-project
Initialized empty Git repository in /path/to/my-project/.git/

.git/
├── HEAD                # 指向当前分支的符号引用
├── config              # 仓库级别的配置文件
├── description         # 仓库描述（仅供 GitWeb 使用，通常忽略）
├── hooks/              # 钩子脚本目录
│   ├── applypatch-msg.sample
│   ├── commit-msg.sample
│   ├── fsmonitor-watchman.sample
│   ├── post-update.sample
│   ├── pre-applypatch.sample
│   ├── pre-commit.sample
│   ├── pre-merge-commit.sample
│   ├── pre-push.sample
│   ├── pre-rebase.sample
│   ├── pre-receive.sample
│   ├── prepare-commit-msg.sample
│   ├── push-to-checkout.sample
│   └── update.sample
├── info/               # 附加信息
│   └── exclude         # 与 .gitignore 类似，但不会被提交到仓库
├── objects/            # 对象存储目录（Git 的核心数据库）
│   ├── pack/           # 打包对象目录（初始为空）
│   └── info/           # 对象信息目录（初始为空）
└── refs/               # 引用目录（指向提交的指针）
    ├── heads/          # 分支引用（初始为空）
    └── tags/           # 标签引用（初始为空）

ref: refs/heads/main

[core]
    repositoryformatversion = 0
    filemode = true
    bare = false
    logallrefupdates = true
    ignorecase = true
    precomposeunicode = true

git init --bare /path/to/repo.git

# 查看当前使用的模板目录
git config --get init.defaultDir

# 使用自定义模板
git init --template=/path/to/template project

# 克隆远程仓库到同名目录
git clone https://github.com/user/repo.git

# 克隆到指定目录
git clone https://github.com/user/repo.git my-directory

# 克隆到当前目录
git clone https://github.com/user/repo.git .

001e# service=git-upload-pack
0000
00a767234abc... HEAD\0multi_ack_detailed side-band-64k thin-pack ofs-delta
003f67234abc... refs/heads/main
003f891def01... refs/heads/develop
003f34567890... refs/tags/v1.0.0

want 67234abc...\0multi_ack_detailed side-band-64k thin-pack ofs-delta
want 891def01...
want 34567890...
done

PACK                    # 4 字节魔数
<version>               # 4 字节版本号（通常为 2）
<num-objects>           # 4 字节对象数量
<object-entry>*         # N 个对象条目
<checksum>              # 20 字节 SHA-1 校验和

[remote "origin"]
    url = https://github.com/user/repo.git
    fetch = +refs/heads/*:refs/remotes/origin/*

[branch "main"]
    remote = origin
    merge = refs/heads/main

# 只克隆最近 1 次提交的历史
git clone --depth 1 https://github.com/user/repo.git

a1b2c3d4e5f6...
f6e5d4c3b2a1...

# 将浅克隆深度扩展到 50
git fetch --depth=50

# 完全深化（获取全部历史）
git fetch --unshallow

# 只克隆 main 分支及其历史
git clone --single-branch --branch main https://github.com/user/repo.git

[remote "origin"]
    fetch = +refs/heads/main:refs/remotes/origin/main

# 修改配置，获取所有分支
git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"
git fetch origin

# 克隆时自动初始化并更新所有子模块
git clone --recurse-submodules https://github.com/user/repo.git

# 等价于克隆后再执行
git submodule init && git submodule update

# 仅初始化子模块，不更新（不检出内容）
git clone --recurse-submodules=no https://github.com/user/repo.git

# 初始化并更新子模块，深度为 1
git clone --recurse-submodules --shallow-submodules --depth 1 \
    https://github.com/user/repo.git

# 只初始化特定路径的子模块
git clone --recurse-submodules=path/to/sub https://github.com/user/repo.git

# 不获取任何 blob（树级过滤），后续按需获取
git clone --filter=blob:none https://github.com/user/repo.git

# 只获取最近 n 次提交中的 blob
git clone --filter=blob:limit=1m https://github.com/user/repo.git

# 不获取树和 blob（仅获取提交）
git clone --filter=tree:0 https://github.com/user/repo.git

# 指定分支后检出
git clone --branch v2.0.0 https://github.com/user/repo.git
# 会导致检出一个分离 HEAD 状态（因为 v2.0.0 是标签）

# 指定远程名称（默认为 origin）
git clone --origin upstream https://github.com/user/repo.git

# 只克隆，不检出工作区
git clone --no-checkout https://github.com/user/repo.git

# 使用特定协议
git clone git@github.com:user/repo.git          # SSH
git clone https://github.com/user/repo.git       # HTTPS
git clone /path/to/local/repo                    # 本地
git clone file:///path/to/local/repo             # 本地（强制走协议层）

.git/
├── HEAD                    # 当前 HEAD 指向（符号引用或直接提交哈希）
├── config                  # 仓库级配置（覆盖 ~/.gitconfig）
├── description             # 仓库描述（GitWeb 使用）
├── index                   # 暂存区（staging area）的二进制文件
├── packed-refs             # 打包引用文件（当引用较多时出现）
│
├── objects/                # 对象数据库（Git 的核心）
│   ├── ab/                 # 以哈希前2字符为目录
│   │   └── c3d4e5...      # 剩余38字符为文件名（松散对象）
│   ├── pack/               # 打包对象
│   │   ├── pack-<hash>.idx # pack 索引文件
│   │   └── pack-<hash>.pack# pack 数据文件
│   └── info/               # 对象信息
│       └── packs           # 可用 pack 文件列表
│
├── refs/                   # 引用（指向对象的指针）
│   ├── heads/              # 分支
│   │   ├── main            # main 分支指向的提交哈希
│   │   └── develop         # develop 分支指向的提交哈希
│   ├── tags/               # 标签
│   │   └── v1.0.0          # v1.0.0 标签指向的对象哈希
│   └── remotes/            # 远程追踪引用（旧版位置）
│
├── logs/                   # 引用日志（reflog）
│   ├── HEAD                # HEAD 的变更历史
│   └── refs/               # 各引用的变更历史
│       └── heads/
│           └── main        # main 分支的变更历史
│
├── hooks/                  # 钩子脚本
│   ├── pre-commit          # 提交前钩子
│   ├── pre-push            # 推送前钩子
│   └── ...
│
├── info/                   # 附加信息
│   ├── exclude             # 本地忽略规则
│   └── refs                # 引用的附加信息
│
├── modules/                # 子模块数据（使用子模块时出现）
│
└── shallow                 # 浅克隆边界文件（浅克隆时出现）

# 场景一：全新项目
git init my-project
cd my-project
# ... 编写代码 ...
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/user/my-project.git
git push -u origin main

# 场景二：参与已有项目
git clone https://github.com/user/existing-project.git
cd existing-project
# ... 修改代码 ...
git add .
git commit -m "Fix: resolve issue #42"
git push

# 场景三：大型仓库快速获取
git clone --filter=blob:none https://github.com/torvalds/linux.git
# 获取完整提交历史，但文件内容按需下载

git init my-project
cd my-project
git remote add origin https://github.com/user/repo.git
git fetch origin
git checkout -b main origin/main     # 创建本地分支并追踪