前置知识: Git

GitHub 概述

9 minBeginner

GitHub 平台核心功能与协作开发流程。

1. GitHub 概述 (Overview)

GitHub 是全球最大的代码托管与协作开发平台,成立于 2008 年,2018 年被 Microsoft 收购。它基于 Git 分布式版本控制系统,为开发者提供代码托管、协作、CI/CD、项目管理等一站式服务。截至 2025 年,GitHub 拥有超过 1 亿开发者和 4 亿+ 仓库。

1.1 核心功能

功能描述优势
代码托管基于 Git 的仓库托管,支持公开和私有仓库代码安全存储,版本可追溯
Pull Request代码审查与合并流程,支持在线讨论和审查保证代码质量,促进团队协作
Issues问题跟踪与任务管理,支持标签、里程碑统一管理 Bug 和功能需求
Actions内置 CI/CD 自动化工作流自动构建、测试、部署
Pages静态网站托管服务免费部署项目文档和个人网站
Codespaces基于云的开发环境随时随地编写代码,无需本地配置
CopilotAI 辅助编程工具智能代码补全,提高开发效率
Projects看板式项目管理工具可视化任务进度,灵活组织工作

1.2 GitHub 发展历程

时间事件
2008GitHub 成立,提供 Git 仓库托管服务
2011用户数突破 100 万
2012获得 A 轮融资 1 亿美元
2016推出 GitHub Pages 和 GitHub Desktop
2018Microsoft 以 75 亿美元收购 GitHub
2019推出 GitHub Actions(CI/CD)
2020代码仓库数量突破 2 亿
2021推出 GitHub Copilot 技术预览
2022GitHub Copilot 正式发布
2023推出 GitHub Copilot Chat
2025用户数突破 1 亿

1.3 GitHub 与 Git 的区别

方面GitGitHub
类型分布式版本控制系统代码托管与协作平台
运行方式本地命令行工具基于 Web 的云服务
核心功能版本控制、分支管理代码托管、协作、CI/CD
是否需要网络否(本地操作)是(远程同步)
费用免费开源免费基础版 + 付费高级功能

2. 账户与计划 (Plans & Pricing)

2.1 账户

  • 个人账户 (Personal Account): 适合个人开发者,免费使用
  • 组织账户 (Organization): 适合团队和企业,支持权限管理

2.2 订阅计划

计划价格主要特性
Free免费无限公开/私有仓库,2,000 CI/CD 分钟/月
Pro$4/月高级代码审查,3,000 CI/CD 分钟/月
Team$4/用户/月组织权限管理,3,000 CI/CD 分钟/月
Enterprise$21/用户/月SAML SSO,50,000 CI/CD 分钟/月

2.3 免费计划限制

  • 私有仓库协作者上限:无限制
  • GitHub Actions 分钟数:2,000 分钟/月
  • GitHub Packages 存储:500 MB
  • GitHub Codespaces:120 核心小时/月

3. 仓库基础 (Repository Basics)

3.1 仓库

  • 公开仓库 (Public): 所有人可见,适合开源项目
  • 私有仓库 (Private): 仅授权用户可见,适合商业项目
  • 内部仓库 (Internal): 组织内部可见(Enterprise 计划)

3.2 仓库结构

my-project/
├── .github/            # GitHub 特定配置
│   ├── workflows/      # GitHub Actions 工作流
│   ├── ISSUE_TEMPLATE/ # Issue 模板
│   └── PULL_REQUEST_TEMPLATE.md
├── src/                # 源代码
├── docs/               # 文档
├── tests/              # 测试
├── .gitignore          # Git 忽略规则
├── LICENSE             # 开源许可证
└── README.md           # 项目说明

3.3 重要文件

文件作用
README.md项目说明文档,仓库首页显示
.gitignore指定 Git 忽略的文件和目录
LICENSE开源许可证
CONTRIBUTING.md贡献指南
CODE_OF_CONDUCT.md行为准则
SECURITY.md安全策略

4. 协作开发流程 (Collaboration Workflow)

4.1 基本协作流程

  1. Fork 仓库到个人账户
  2. Clone 到本地开发环境
  3. 创建分支 进行功能开发
  4. 提交代码 并推送到远程
  5. 创建 Pull Request 请求合并
  6. 代码审查 团队成员审查代码
  7. 合并代码 审查通过后合并到主分支

4.2 分支策略

策略描述适用场景
GitHub Flow基于主分支创建功能分支,PR 合并持续部署项目
Git Flow包含 develop、feature、release、hotfix 分支版本发布项目
Trunk-Based所有人在主分支上开发,使用特性开关高频发布项目

4.3 代码审查最佳实践

  • PR 保持小规模,便于审查
  • 编写清晰的 PR 描述
  • 使用代码注释标记审查意见
  • 及时回复审查意见
  • 合并前确保 CI 通过

5. 常用快捷操作 (Tips & Tricks)

5.1 键盘快捷键

快捷键功能
.在 Web 编辑器中打开仓库
T文件搜索
W分支切换
L跳转到指定行
B查看 Blame 信息
?显示所有快捷键

5.2 Markdown 技巧

  • 使用 [ ][x] 创建任务列表
  • 使用 @mention 提及用户或团队
  • 使用 #issue 引用 Issue
  • 使用 commit_sha 引用提交

5.3 搜索语法

language:python stars:>1000   # Python 项目,星标超过 1000
topic:react fork:true         # React 主题,包含 Fork
owner:facebook path:src       # Facebook 仓库,src 目录下

6. 生态与集成 (Ecosystem)

6.1 GitHub 生态工具

工具用途
GitHub CLI (gh)命令行操作 GitHub
GitHub Desktop形化 Git 客户端
GitHub Mobile移动端管理仓库
GitHub Codespaces云端开发环境
GitHub CopilotAI 编程助手
GitHub Packages包注册与托管
GitHub Registry容器镜像托管

6.2 第三方集成

  • CI/CD: Jenkins, CircleCI, Travis CI
  • 监控: Datadog, New Relic, Sentry
  • 通信: Slack, Microsoft Teams, Discord
  • 项目管理: Jira, Linear, Asana

7. 学习路径 (Learning Path)

7.1 入门阶段

  1. 注册 GitHub 账户并配置 2FA
  2. 创建第一个仓库
  3. 学习 Git 基本操作
  4. 编写 README 和文档

7.2 进阶阶段

  1. 掌握 Pull Request 工作流
  2. 使用 GitHub Actions 自动化
  3. 配置分支保护规则
  4. 参与 Issue 讨论

7.3 高级阶段

  1. 搭建 CI/CD 流水线
  2. 使用 GitHub Pages 部署站点
  3. 开发 GitHub Actions 插件
  4. 管理大型开源项目

8. 总结

GitHub 是现代软件开发的基础设施,掌握其核心功能对开发者至关重要。从基础的代码托管到高级的 CI/CD 自动化,GitHub 提供了完整的开发协作工具链。

8.1 关键要点

  • 版本控制: Git 是基础,GitHub 是平台
  • 协作开发: Pull Request 是核心协作流程
  • 自动化: GitHub Actions 实现 CI/CD
  • 安全: 2FA 和分支保护保障代码安全
  • 开源: GitHub 是全球最大的开源社区

更新日志 (Changelog)

  • 2026-06-04: 创建 GitHub 概述文档。