1. 什么是代码库

在禅道 DevOps 平台中，“代码库 (Repository)” 是存放项目源代码、配置文件、文档等研发资产的基础载体，也是流水线执行构建、测试、部署等操作最核心的数据源。

代码库隶属于某一个空间，依托空间完成团队权限管控与资源归类，让研发代码资产能够有序存放、高效协同。

平台支持管理多种类型的源代码管理工具，包括内置GIt服务（GitFox），以及流行的GitLab、Gitea、Gogs等源代码托管平台。

2. 功能特性

归属空间绑定：代码库必须归属于一个指定空间，一个空间下可管理多个代码库，实现资产集中收纳。 

版本管理：保存代码全量提交历史、分支、标签记录，支持多人并行开发，可随时回溯任意历史版本。 

分支管理：支持创建功能分支、发布分支、主干分支，适配团队不同的开发工作流。 

仓库级权限：可在空间权限基础之上，对单个代码库做精细化权限管控，区分只读、提交、管理员等角色。 

流水线触发源：代码提交、合并请求等事件可直接触发对应流水线任务，打通代码变更‑自动化流程。

WebHook 能力：可向外推送代码变更事件，对接第三方工具，实现研发流程联动。

3. 为什么引入代码库概念？

引入代码库的核心目的是统一管理源代码资产，实现研发过程可追溯、可协同：

资产统一收纳：将项目所有源代码集中托管，避免代码分散存放、文件丢失。

多人协同开发：团队成员可以基于同一个代码库并行编写代码，减少文件冲突。

变更可追溯：每一次代码改动都会留下记录，方便排查问题、复盘迭代。

流程自动化入口：代码库作为源头，驱动流水线自动化构建、测试与发布，落地 DevOps 持续交付。

4. 最佳实践建议

按独立项目 / 模块建库：一个独立业务模块建议创建一个代码库，不要把多个无关业务代码放到同一个库。

库‑空间归属清晰：同一产品线的所有代码库归入对应的产品线空间，方便统一管理权限。

分支规范先行：新建仓库时提前约定主干分支、发布分支命名规则，统一团队开发规范。 

权限最小化配置：仅给需要开发权限的成员开放提交权限，其余人员配置只读权限，降低误改风险。 

做好仓库分类：业务项目库放入私有空间；通用组件、公共工具库可放入公开空间，实现企业内共享复用。