源代码管理工具介绍

一、源代码管理工具
源代码管理工具用于跟踪代码的变更历史，支持多人协作开发。它的核心作用是：多人可以同时修改同一项目，不会互相覆盖；所有历史版本可追溯，出问题可以随时回退。

二、主流源代码管理工具

工具	特点	适用场景
GitHub	基于Git，云端托管，全球最大开源社区，支持PR、Issues、Actions	开源项目、中小团队、个人开发者
GitLab	自托管，内置CI/CD，DevOps一体化	企业私有部署
TFS / Azure DevOps	微软出品，与Visual Studio集成好	.NET生态、大型企业
Gitee	国内访问快，免费私有仓库	国内团队、不想FQ的项目

三、为什么选择GitHub
对于“港城青隅”项目而言，GitHub是最合适的源代码管理工具，理由如下：

• 免费私有仓库：GitHub为学生提供免费的私有仓库，团队代码可以不公开

• 协作流程成熟：Pull Request + Code Review是行业标准

• 生态完善：Issues管任务、Projects看板管进度、Actions做自动化

四、GitHub核心功能介绍

4.1 仓库（Repository）

每个项目对应一个仓库。对于“港城青隅”，如果托管在GitHub，可以创建以下仓库结构：

• frontend：微信小程序前端代码
• backend：后端API服务
• docs：设计文档、API文档

4.2 分支与Pull Request
GitHub Flow核心流程：

• main分支保护，不能直接推送
• 新功能从main切出新分支
• 开发完成后创建Pull Request（PR）
• 团队成员Review通过后合并

举例：

假设团队成员A开发“高校邮箱注册”功能。他从main切出feature/email-register分支，写完代码后提交PR。团队成员B作为Reviewer查看代码，发现邮箱验证的正则表达式有问题，在PR评论区指出。A修改后再次推送，B确认无误后合并。整个过程所有讨论和修改记录都保留在PR中。

4.3 Issues（任务管理）
用Issues跟踪Bug和功能需求。每个Issue可以：分配负责人、打标签（bug/enhancement）、关联PR。

举例：

假设测试人员发现“社交雷达卡片滑动时偶尔卡顿”，在GitHub上创建Issue #23 修复雷达卡片滑动卡顿，分配给前端开发，并打上bug标签。开发修复后，在PR描述中写Closes #23，合并时Issue自动关闭。

4.4 GitHub Actions（自动化）
可以配置自动化流程，例如：每次推送代码自动运行测试、自动部署到服务器。

举例：

假设团队在.github/workflows中配置了CI流程：每次有人推送代码到main分支，GitHub会自动运行后端单元测试。如果测试失败，团队会收到邮件通知。这样确保合并到主分支的代码至少是“能跑通测试”的。

4.5 Projects（看板）
用看板管理开发进度，典型的三列结构：To Do → In Progress → Done。

五、GitHub vs TFS 简要对比

维度	GitHub	TFS / Azure DevOps
托管方式	云端为主	本地部署或云端
学习成本	低，教程丰富	较高，需熟悉微软生态
开源生态	全球最大	较弱
与IDE集成	VS Code、JetBrains全家桶	Visual Studio深度集成
CI/CD	GitHub Actions	Azure Pipelines
适合团队	中小团队、开源项目	.NET企业团队

对于“港城青隅”这类学生课程项目，GitHub完全够用，而且比TFS更轻量、更方便。

六、总结
源代码管理工具是团队协作的基础设施。没有它，多人开发同一项目会陷入“代码被覆盖”“改错了回不去”等各种问题。

GitHub的核心价值：

• 记录：谁、什么时候、为什么改了哪行代码

• 协作：通过PR和Review保证代码质量

• 自动化：CI/CD减少重复劳动

对于我们团队来说，GitHub是目前最合适的选择。未来进入企业，可能还会接触到GitLab、TFS等工具，但掌握Git和GitHub Flow这套思路，是通用的基本功。