上游 · 理解本功能前需先掌握的(1):
下游 · 依赖/承接本功能的(0):
暂无下游(建议学完它再进阶)
前置依赖包含从属概念升级流程承接
边方向 = 学习顺序(A→B 表示先学 A 再学 B)
为什么需要它
心智模型
人一多、仓库一多,一个一个给人设权限就成了灾难:新人入职要给 20 个仓库各加一遍权限,离职又要删 20 遍。团队(Team)就像公司的「部门花名册」——你把权限发给「部门」,人进部门就自动获得权限,换人只动花名册,不用动仓库。它解决的是「多人、多仓库」时代的权限规模化问题。
历史背景 · 它为什么诞生诞生于 2010
诞生公司与大型开源项目需要把多个仓库和成员集中管理,此前只能管理多个账号或共享账号。2010-06-29 Organizations上线,提供组织级仪表盘、集中计费、按团队批量授权,并支持把账号转换为组织。
演进从基础组织演变为企业治理体系:2017支持嵌套团队与安全设置;2017-2021加入SAML SSO、自动化入职/离职、团队与用户级权限、企业托管用户,最终成长为企业级身份与访问管理平台。
历史教训
协作规模的第一个阈值是"个人→团队":组织/团队把多人协作从非正式约定变成可配置的结构。治理类能力往往最晚出现,却决定了平台能否服务大企业。
功能介绍
团队(Team)是组织(Organization)内的权限管理单元。先解释组织:组织是 GitHub 上专为企业、开源项目或多成员项目设计的账号形态,一个组织下可以有多个仓库(Repository)和多个成员。团队就是组织里的一组人,比如「前端组」「后端组」,每个团队可以被授予一个或多个仓库的特定权限级别(读取 Read / 写入 Write / 管理 Admin / 维护 Maintain)。关键机制是权限继承:只要你把某个人加入一个团队,他就自动获得该团队名下所有仓库的权限;把某个人移出团队,权限也随之收回。这意味着权限和人是解耦的——权限挂在「岗位」上,而不是挂在具体的人身上。个人仓库的协作者功能适合小规模,团队(Team)则适合企业或多人长期项目,因为它是组织级的批量管理。
核心术语
团队(Team)组织(Organization)仓库(Repository)权限级别(Permission Level)维护权限(Maintain)
适用场景
- 当你的项目团队超过几个人、且成员会流动时,用组织+团队统一管权限。
- 当公司或项目有很多仓库,需要给一批人批量授权时,把权限挂在团队上。
- 当新人入职、旧人离职时,只增删团队成员,不动任何仓库设置。
- 当你想按职能分工(如前端组、后端组、评审组)管理协作时,创建对应团队。
怎么操作(网页 vs 命令行 双轨)
🖱️ 网页操作 (GitHub.com)
- 在组织页面点击 Teams → New team,填写团队名称和可见性后创建。
- 进入团队页面,点击 Members → Add a member 添加成员。
- 点击 Repositories → Add repository,选择仓库并设置该团队对该仓库的权限级别。
- 之后成员权限自动随团队生效,修改权限只需调整团队设置。
⌨️ 命令行 (进阶)
gh api -X POST /orgs/你的组织/teams -f name=前端组gh api -X PUT /orgs/你的组织/teams/前端组/memberships/用户名gh api -X PUT /orgs/你的组织/teams/前端组/repos/组织名/仓库名 -f permission=push
新手建议先从网页操作入手,熟悉概念后再尝试命令行。命令行是真实开发中更常用的方式。
与其他功能的关系
| 关系(前置依赖 / 包含从属 / 概念升级 / 流程承接) | 说明 |
|---|---|
| 概念升级协作者权限(Collaborator Permission) | 从单个协作者升级到组织内的团队权限管理 |
官方文档
小结
SUMMARY
团队(Team)= 组织里的权限组:权限挂在团队上,人进组自动获权,人出组自动失效。它是多人多仓库项目的管理利器。协作能力到此学完,下一步进入 G04,用 Issue 管理项目的待办事项。