编辑“︁Git仓库组织结构”︁

{{DISPLAYTITLE:Git仓库组织结构}}  
{{Note|本文适用于Git初学者及需要系统化理解仓库结构的开发者。}}  

== 概述 ==  
'''Git仓库组织结构'''指版本控制系统中代码库的目录布局、分支策略及文件管理规范。合理的组织结构能提升协作效率、简化维护成本，并为持续集成/交付（CI/CD）奠定基础。核心要素包括：  
* 标准目录结构（如`src/`、`docs/`等）  
* 分支模型（如Git Flow、GitHub Flow）  
* 子模块（Submodules）与子仓库（Subtrees）管理  
* 忽略规则（`.gitignore`）  

== 标准目录结构 ==  
推荐的基础目录结构如下（以Web项目为例）：  

```plaintext
project-root/  
├── src/                  # 源代码  
│   ├── main/             # 主程序逻辑  
│   └── test/             # 单元测试  
├── docs/                 # 文档  
├── scripts/              # 构建/部署脚本  
├── config/               # 配置文件  
└── .gitignore            # 忽略规则  
```

=== 关键目录说明 ===  
* `src/`：严格区分生产代码与测试代码，符合[[w:Maven|Maven]]等工具约定。  
* `docs/`：存放API文档、设计稿等，建议使用Markdown格式。  
* `.gitignore`：示例规则：  

```ini
# 忽略编译产物  
/target/  
*.class  

# 忽略IDE文件  
.idea/  
*.iml  
```

== 分支策略 ==  
=== Git Flow模型 ===  
<mermaid>  
gitGraph  
    commit  
    branch develop  
    checkout develop  
    commit  
    branch feature/login  
    checkout feature/login  
    commit  
    checkout develop  
    merge feature/login  
    branch release/1.0  
    checkout release/1.0  
    commit  
    checkout main  
    merge release/1.0  
    checkout develop  
    merge release/1.0  
</mermaid>  

* '''main'''：稳定版本，对应生产环境。  
* '''develop'''：集成测试分支。  
* '''feature/*'''：功能开发分支，命名如`feature/user-auth`。  
* '''release/*'''：预发布分支，用于版本号标记。  

=== 代码示例：创建分支 ===  
<syntaxhighlight lang="bash">  
# 从develop创建功能分支  
git checkout -b feature/email-notification develop  

# 推送至远程  
git push -u origin feature/email-notification  
</syntaxhighlight>  

== 子模块与子仓库 ==  
=== Git Submodule ===  
用于嵌入外部仓库（如公共库）：  
<syntaxhighlight lang="bash">  
# 添加子模块  
git submodule add https://github.com/jquery/jquery.git libs/jquery  

# 初始化（克隆后需执行）  
git submodule update --init --recursive  
</syntaxhighlight>  

=== 子树（Subtree） ===  
更适合频繁更新的依赖：  
<syntaxhighlight lang="bash">  
# 添加远程仓库  
git remote add lib-utils https://github.com/example/utils.git  

# 合并子树  
git subtree add --prefix=libs/utils lib-utils main --squash  
</syntaxhighlight>  

== 实际案例 ==  
=== 案例1：开源项目结构 ===  
以[[w:React (JavaScript library)|React]]为例：  
* `packages/`：核心模块分目录存储  
* `scripts/`：构建工具链  
* 使用`lerna`管理多包仓库  

=== 案例2：企业级微服务 ===  
```plaintext  
services/  
├── user-service/      # 用户服务  
│   ├── src/  
│   └── Dockerfile  
├── order-service/     # 订单服务  
└── .gitmodules        # 子模块配置  
```  

== 数学表达 ==  
分支合并冲突概率模型（假设独立修改文件）：  
<math>  
P(conflict) = 1 - \left(1 - \frac{f}{N}\right)^m  
</math>  
其中：  
* <math>f</math>：冲突文件数  
* <math>N</math>：总文件数  
* <math>m</math>：修改次数  

== 最佳实践总结 ==  
# 目录结构遵循语言/框架惯例  
# 分支命名清晰（如`fix/issue-123`）  
# 使用`.gitignore`排除生成文件  
# 大型项目优先选用子树而非子模块  

{{Tip|定期执行`git gc`优化仓库性能。}}

[[Category:集成部署]]
[[Category:Git]]
[[Category:Git最佳实践]]