Git 实用指南：从重置仓库到代码贡献标准工作流 • 20Bytes Log

1. 从本地代码重建全新的 GitHub 仓库#

有时候本地已经有一份代码，但原来的 Git 仓库历史不再需要。最直接的做法是删除旧的 Git 信息，然后在 GitHub 上新建一个空仓库重新提交。

核心步骤#

删除本地旧 Git 信息：
```
cd /path/to/your/project-name
rm -rf .git
```
bash
这会清空提交历史和远程关联，但保留代码文件。
重新初始化本地仓库：
```
git init
git branch -M main
```
bash
在 GitHub 新建空仓库：不要勾选 README、.gitignore 或 License。

关联新的远程仓库并推送：

git remote add origin [https://github.com/your-username/your-repo-name.git](https://github.com/your-username/your-repo-name.git)
git add .
git commit -m "Initial commit"
git push -u origin main

bash

2. 代码贡献与团队协作标准工作流 (Workflow)#

对于参与团队项目，我们有一套标准的协作流程。强烈建议在开始前系统学习 Git 的版本管理。

2.1 环境准备与克隆#

登录：使用加入了该 repo 权限的 GitHub 账号登录。
下载 Git：Git 官方下载 ↗
克隆仓库：获取远程代码到本地，请务必使用 git clone 而不是直接 Download ZIP。(如果国内使用不稳定，建议配置好网络环境)。

git clone [https://github.com/your-organization/your-repo-name.git](https://github.com/your-organization/your-repo-name.git)

bash

2.2 同步主分支与创建开发分支#

每次开发新功能前，确保基于最新的 main 分支拉取新的工作分支：

# 切换到主分支并同步远程最新代码
git checkout main 
git pull 

# 创建并切换到新分支进行开发
git checkout -b feature-your-new-task

bash

分支命名规范：

一个分支只对应一个任务。

名称通常为 2-3 个单词，尽量简洁明了（如 feature-login-page）。

如果可能重名，可以加时间戳避免冲突（如 feature-login-250601）。

好例子：issue-15

坏例子：yaml（缺乏信息量）、branch-new-feature（没必要加 branch 前缀）

2.3 编写代码与提交 (Commit)#

修改代码时，请始终确保自己在刚才创建的任务分支上工作（可通过 VSCode 左下角状态栏确认）。

AI 辅助：尽量利用 AI（Cursor / Claude / Trae）辅助编程，可通过 @ 引入文件或整个代码库上下文。
提交原则：提交前必须进行测试。每次提交应尽可能小但完整。切勿提交庞大的数据文件！
提交流程：强烈建议使用 VSCode 自带的图形化界面（Source Control）进行 add 和 commit，这比纯命令行更直观。

Commit Message 规范：

标题行（首行）：5-10 个词，简明扼要。

详细正文（可选）：与标题行空一行，用 1-3 句话描述复杂的变更细节。

2.4 发布分支与合并请求 (Pull Request)#

尽早与 Reviewer 分享你的代码以获取反馈。

推送分支：点击 VSCode 中的 Publish/Push 按钮，或者运行：
```
git push -u origin your-branch-name
```
bash
创建 PR：在 GitHub 上针对刚才推送的分支发起 Pull Request (PR)。
- 注意：非常小心地检查 PR 的目标分支（通常是 origin/main）。
- PR 标题：一般 5-10 个单词，以动词开头（例如：“add user login feature”）。不要用 “fix a bug” 这种过于宽泛的标题。
- PR 描述：如有需要，请将测试结果、详细说明粘贴到评论中，附上截图更佳。

2.5 代码审查 (Review)#

在 GitHub 上请求审阅（Request Reviews），或者在评论中 @reviewer。
若具备权限，推荐添加 GitHub Copilot 等 AI 工具作为辅助审阅者。
根据反馈修改代码，提升 PR 质量，直到获得 Approval。

3. 学习资源与参考资料#

如果你想深入学习 Git，以下资源非常值得推荐：

官方与图形化教程：
- Atlassian Git Tutorials ↗
- VSCode 中的 Git 使用指南 ↗
可视化交互式学习：
- Learn Git Branching ↗（强推！以可视化的方式学习 Git 分支）
底层原理解读：
- 【中文字幕】Linus 在 2007 年 Google Talk 上介绍 Git ↗
- 深入理解 Git Merge 工作原理 ↗