编辑“︁Git裸仓库”︁

= Git裸仓库 =

== 概述 ==
'''Git裸仓库'''（Bare Repository）是一种不包含工作目录的特殊Git仓库，仅由`.git`目录的内容构成。这类仓库专门用于代码共享和协作，常见于中央服务器（如GitHub、GitLab等托管服务的底层存储结构）。与常规仓库不同，裸仓库不允许直接修改文件，而是通过推送（`push`）和拉取（`pull`）操作与其他仓库交互。

裸仓库的命名通常以`.git`结尾（例如`project.git`），其核心特征是：
* 无工作树（Working Tree），因此无法执行`git add`或`git commit`等操作
* 仅存储Git对象（提交历史、分支、标签等）
* 作为远程仓库的“中心节点”使用

== 创建裸仓库 ==
通过`git init --bare`命令创建：

<syntaxhighlight lang="bash">
# 创建裸仓库
git init --bare myproject.git

# 输出示例
Initialized empty Git repository in /path/to/myproject.git/
</syntaxhighlight>

目录结构如下（通过`tree -L 1`查看）：
<syntaxhighlight lang="text">
myproject.git/
├── HEAD
├── branches
├── config
├── description
├── hooks
├── info
├── objects
└── refs
</syntaxhighlight>

== 裸仓库 vs 非裸仓库 ==
{| class="wikitable"
|+ 对比特性
! 特性 !! 裸仓库 !! 非裸仓库
|-
| 工作目录 | ❌ 不存在 | ✅ 存在
|-
| 直接提交 | ❌ 不可用 | ✅ 可用
|-
| 典型用途 | 中央代码库 | 本地开发
|-
| 克隆方式 | 需非裸克隆 | 可裸克隆/非裸克隆
|}

== 实际应用场景 ==

=== 场景1：搭建中央仓库 ===
团队开发时，裸仓库常作为共享代码库：
<mermaid>
graph LR
    A[开发者A] -->|push/pull| C[(裸仓库 server.git)]
    B[开发者B] -->|push/pull| C
</mermaid>

=== 场景2：备份仓库 ===
将本地仓库转换为裸格式以节省空间：
<syntaxhighlight lang="bash">
# 克隆为裸仓库
git clone --bare /path/to/project project-backup.git

# 验证内容
cd project-backup.git
git log --oneline  # 可查看历史记录
</syntaxhighlight>

== 高级操作 ==

=== 推送至裸仓库 ===
假设已有本地仓库，将其关联到裸仓库：
<syntaxhighlight lang="bash">
# 本地仓库操作
cd my-project
git remote add origin /path/to/myproject.git
git push origin main

# 输出示例
Counting objects: 17, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (13/13), done.
Writing objects: 100% (17/17), 1.45 KiB | 0 bytes/s, done.
Total 17 (delta 2), reused 0 (delta 0)
To /path/to/myproject.git
 * [new branch]      main -> main
</syntaxhighlight>

=== 从裸仓库克隆 ===
其他开发者可克隆此裸仓库进行协作：
<syntaxhighlight lang="bash">
git clone /path/to/myproject.git
cd myproject  # 自动生成工作目录
</syntaxhighlight>

== 数学表示 ==
裸仓库可视为Git对象的纯集合：
<math>
\mathcal{R}_{\text{bare}} = \{ \text{objects}, \text{refs}, \text{config}, \ldots \}
</math>
其中常规仓库是裸仓库与工作目录的并集：
<math>
\mathcal{R}_{\text{normal}} = \mathcal{R}_{\text{bare}} \cup \mathcal{W}
</math>

== 注意事项 ==
* '''权限管理'''：裸仓库通常需要配置文件系统权限
* '''钩子脚本'''：可通过`hooks/`目录自动化流程（如代码审查）
* '''存储优化'''：定期运行`git gc`压缩历史记录

== 总结 ==
Git裸仓库是分布式版本控制系统的核心组件，理解其原理有助于：
* 搭建私有Git服务器
* 优化存储结构
* 设计高效的协作流程

初学者可通过实践`git init --bare`和克隆操作直观体会其作用，而高级用户可利用裸仓库构建自定义的代码托管系统。

[[Category:集成部署]]
[[Category:Git]]
[[Category:Git高级操作]]