源代码管理工具博客

今天这次博客介绍的是GitHub。

在 GitHub 上进行源代码管理主要依赖于 Git 版本控制 和 GitHub 平台功能。

在进行源代码管理之前，Git 有五项基础功能需要了解：
仓库（Repository）：项目代码的存储位置，可以是本地或远程。
提交（Commit）：代码变动的存档，包含更改描述。
分支（Branch）：独立开发线，默认分支通常是 main 或 master。
合并（Merge）：将一个分支的更改整合到另一个分支。
拉取请求（Pull Request, PR）：请求将代码合并到主分支，用于代码审查。

程序员可以添加一个库（repository）来上传源代码。而其他组员如果想要对代码进行改动，可以去issue区进行代码修改

就是在这个区，每个程序员都能对代码做出自己的贡献。

在 GitHub 上提交 PR：
进入你的 Fork → Pull Requests → New Pull Request。
选择 base: main（目标分支）和 compare: fix/bug（你的分支）。
填写 PR 描述，等待审核和合并。

组员们的每一次改动都会有历史记录。

团队可以清楚地看到组员们的想法与意见。
如果对改动不满意，也可以回溯上一次的历史版本。
这就是github在源代码管理这一块高效的地方。

假如要对我们的团队项目“食尚指南”进行源代码管理，应该怎么做呢？
首先是在 GitHub 上创建新仓库，在repository区，给项目取一个自己喜欢的名字

然后是分支策略（团队协作场景）
采用 Git Flow 或简化版分支模型：
main：稳定版，仅允许通过 PR 合并。
develop：集成开发分支。
feature/xxx：新功能开发。
fix/xxx：Bug 修复。
开发新功能的代码示例：

点击查看代码

# 从 develop 创建新分支
git checkout develop
git pull origin develop  # 确保同步最新代码
git checkout -b feature/recipe-upload

# 开发完成后提交
git add .
git commit -m "Add recipe upload functionality"
git push origin feature/recipe-upload

# 在 GitHub 创建 PR，请求合并到 develop

所有代码需通过 Pull Request (PR) 合并，至少 1人审核。PR 描述需明确，信息提交要规范。
如果想要自动部署的话，也可以使用 Vercel（前端）或 Heroku（后端）关联 GitHub，实现 main 分支推送后自动部署。

假如出现了一些未曾预料的应急场景，可以尝试以下操作：
1、回滚代码

点击查看代码

# 查看历史提交
git log --oneline

# 回滚到指定提交
git revert <commit-hash>  # 推荐：生成反向提交
git reset --hard <commit-hash>  # 慎用：彻底删除后续提交

2、修复生产环境 Bug

点击查看代码

git checkout main
git pull origin main
git checkout -b hotfix/login-error
# 修复后直接合并到 main 并打标签

其他的项目管理辅助还有：
GitHub Projects，可以创建看板管理任务（To Do、In Progress、Done）。
Issues 模板，可以标准化 Bug 报告和功能请求。

在github上的源代码开发总结下来的流程就是
本地开发 → 提交到 feature 分支 → 推送 → 创建 PR → Code Review → 合并到 develop/main → 自动化测试/部署 → 打标签发布
通过以上流程，“食尚指南”可以实现高效、安全的源代码管理