Github创建上传仓库流程

🛠️ 团队高效协作与 Git 工作流全景指南

在敏捷开发与团队协作中，规范的 Git 工作流是保障代码质量与项目演进的稳固基石。本文系统梳理了从基础规范、从零提交到 Fork 开源贡献的完整流程，帮助开发者杜绝"乱交代码"、"误删冲突"等常见顽疾。

🗺️ 一、 Git 整体架构与流转图

Git 的核心逻辑建立在 工作区 (Working Directory) 、暂存区 (Staging Area) 、本地仓库 (Local Repo) 与 远程仓库 (Remote Repo) 四个区域的状态流转之上：

📐 二、团队 Git 协作规范

1. 🔗 远程仓库配置规范

bash 复制代码

# 查看当前关联的远程仓库详情
git remote -v

# 关联新的远程仓库
git remote add origin <URL>

# 修改已有远程仓库地址
git remote set-url origin <URL>

2. 🔀 分支开发与管理规范

为了保证主线代码的稳定，项目开发必须遵循严密的分支策略，严禁直接在主干分支修改代码。

bash 复制代码

[ master / main ] ─── (线上稳定代码) ─────────────────────────►
       │
 [ develop ] ──────── (开发主干分支) ─────────────────────────►
       │                      │
       ├─── [ feature/xxx ] ──┘ (新功能开发)
       │
       └─── [ hotfix/xxx ] ───► (线上紧急 Bug 修复)

master / main：线上生产环境代码，必须经过严格测试且由指定负责人合并。
develop：日化开发集成分支，最新的功能均在此交汇。
feature/xxx：新功能开发分支（如 feature/login-v2）。
bugfix/xxx：常规缺陷修复分支。
hotfix/xxx：线上紧急 Bug 修复分支。

📌 日常开发基本动作：

开工前： 先切至正确分支，检查当前状态：

bash 复制代码

git status

同步基线： 拉取远程最新代码至本地：

bash 复制代码

git pull origin develop

推送功能： 将本地 feature 分支推送到远端：

bash 复制代码

git push origin feature/xxx

3. 🔍 提交与 Code Review 校验机制

💡 代码自查 (Pre-commit Check)

在执行 git commit 前，必须运行 git diff 进行差异核对，清理：

遗留的调试代码（如 console.log / printf / print）

本地临时配置文件与含有敏感信息的密钥/Token

📝 Commit Message 规范

严禁使用 111、fix、改了一下等无意义词汇。推荐使用 Angular 提交规范 格式：

type: 简要说明 (如 fix: 修复用户登录页面的内存泄漏问题)

🧪 MR / PR 提交流程自查清单

在发起 Merge Request (MR) 或 Pull Request (PR) 前，请完成以下自我 CheckList：

代码在本地能否正常构建运行？
自动化测试或单元测试是否全数通过？
是否不小心引入了无关文件（如编译产物、日志、系统文件）？
是否包含配置文件密码或 API 私钥？
Commit 信息是否表达清晰且关联了对应 Issue？
Merge Target（目标合并分支）是否选择正确（通常为 develop）？

4. 🧰 常用实用命令速查

📜 查看提交历史

Bash 复制代码

# 查看完整日志
git log

# 查看精简单行日志
git log --oneline

# 树状展示全部分支图谱
git log --oneline --graph --all

📦 临时工作区压栈与恢复 (Stash)

当需要临时中断当前开发去处理紧急问题时使用：

Bash 复制代码

# 将当前未提交的修改暂存起来
git stash

# 查看暂存列表
git stash list

# 恢复最新的暂存内容并删除记录
git stash pop

↺ 代码回退与撤销

Bash 复制代码

# 撤销工作区中指定文件的未 add 修改
git restore <filename>

# 将已 add 到暂存区的文件移回工作区
git restore --staged <filename>

# 【慎用】强行覆盖回退到某次 commit (会直接丢弃未提交的修改)
git reset --hard <commit_id>

# 【推荐】协作模式下的安全撤销 (生成一次新的反向提交)
git revert <commit_id>

🚀 三、从零初始化并将本地项目推送到 GitHub

当本地已有代码项目，需要初始化并推送至新建的 GitHub 空仓库时，请参照以下完整流程：

bash 复制代码

# 1. 进入本地项目根目录
cd /d/myproject

# 2. 初始化 Git 仓库，并将默认主分支直接指定为 main
git init -b main

# 3. 关联 GitHub 远程仓库
git remote add origin [https://github.com/github789i/prompt-awesome.git](https://github.com/github789i/prompt-awesome.git)

# 4. 将本地代码添加至暂存区并完成首次提交
git add .
git commit -m "feat: initial commit from local project"

# 5. 拉取远程仓库文件并允许历史不相关合并 (针对 GitHub 上自动生成了 README/License 的仓库)
git pull origin main --allow-unrelated-histories

# 6. 将合并后的完整本地代码推送到远程仓库并建立跟踪
git push -u origin main

⚡ 终端网络连接超时（Connection Timeout）排查与解决

若在执行 git pull/push 时遇到 fatal: unable to access ...: Failed to connect to github.com port 443 错误，通常是因为终端未走网络代理。

解决步骤（以本地代理端口 7890 为例）：

bash 复制代码

# 开启终端 HTTP/HTTPS 代理
git config --global http.proxy [http://127.0.0.1:7890](http://127.0.0.1:7890)
git config --global https.proxy [http://127.0.0.1:7890](http://127.0.0.1:7890)

# 取消代理设置（网络恢复后或不需要时执行）
git config --global --unset http.proxy
git config --global --unset https.proxy

🤝 四、开源项目贡献与 Fork 协作工作流

当需要参与第三方开源项目或协作更新他人代码时，正确的标准流程为：

Fork 仓库 → Clone 到本地 → 配置 Upstream → 本地修改与提交 → Push 到个人 Fork → 发起 Pull Request

bash 复制代码

# 1. 在 GitHub 上点击右上角 "Fork"，将目标项目克隆到自己的账号下
# 假设自己的仓库地址为: [https://github.com/yourname/repo-name.git](https://github.com/yourname/repo-name.git)

# 2. 将个人 Fork 后的仓库 Clone 至本地
cd /e/postgraduatestudent/coding/
git clone [https://github.com/yourname/repo-name.git](https://github.com/yourname/repo-name.git)
cd repo-name

# 3. 添加原作者的上游仓库 (upstream)，便于后续同步原作者的更新
git remote add upstream [https://github.com/original-author/repo-name.git](https://github.com/original-author/repo-name.git)

# 4. 检查远程分支状态，确认 origin 和 upstream 设置无误
git remote -v

# -------------------------------------------------------------
# 5. 同步原作者最新代码（开发前必备操作）
git pull upstream main
git push origin main

# 6. 本地创建新的特性分支进行修改开发
git checkout -b feature/my-new-feature

# 7. 完成修改后提交变更
git add .
git commit -m "fix: resolve memory leak in user authentication"

# 8. 推送至【个人 Fork 的仓库 (origin)】，注意不要直接 Push 到 upstream
git push origin feature/my-new-feature

# 9. 提交 Pull Request (PR)
# 登录 GitHub 进入自己的 Fork 仓库页面，点击醒目的 "Compare & pull request" 按钮，
# 填写清晰的说明文档后提交，等待原作者 Code Review 与合并。

Github创建上传仓库流程

🛠️ 团队高效协作与 Git 工作流全景指南

🗺️ 一、 Git 整体架构与流转图

📐 二、 团队 Git 协作规范

1. 🔗 远程仓库配置规范

2. 🔀 分支开发与管理规范

📌 日常开发基本动作：

3. 🔍 提交与 Code Review 校验机制

💡 代码自查 (Pre-commit Check)

📝 Commit Message 规范

🧪 MR / PR 提交流程自查清单

4. 🧰 常用实用命令速查

📜 查看提交历史

📦 临时工作区压栈与恢复 (Stash)

↺ 代码回退与撤销

🚀 三、 从零初始化并将本地项目推送到 GitHub

⚡ 终端网络连接超时（Connection Timeout）排查与解决

🤝 四、 开源项目贡献与 Fork 协作工作流

📐 二、团队 Git 协作规范

🚀 三、从零初始化并将本地项目推送到 GitHub

🤝 四、开源项目贡献与 Fork 协作工作流