GitHub提交流程全攻略

本文系统讲解了将本地代码变更同步至 GitHub 的标准五步 Git 提交流程：从初始化或关联远程仓库、添加文件到暂存区、提交带清晰描述的变更、推送至远程分支，到妥善处理因远程更新导致的推送冲突；每一步均配有具体命令、使用场景说明和实用提示，帮助开发者高效、规范、零失误地完成代码协作的关键操作。

如果您已完成本地代码开发，希望将更改同步到 GitHub 远程仓库，则需要执行标准的 Git 提交流程。以下是完成此操作的步骤：

一、初始化本地仓库或关联远程仓库

若本地项目尚未纳入 Git 版本控制，需先初始化；若已存在本地仓库但未关联 GitHub 远程地址，则需添加远程源。该步骤确保本地与远程仓库建立通信基础。

1、打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），进入项目根目录。

2、执行 git init 初始化本地 Git 仓库（仅首次使用时需运行）。

3、执行 git remote add origin https://github.com/用户名/仓库名.git 关联 GitHub 远程仓库（替换 URL 为实际地址）。

4、执行 git remote -v 验证远程仓库地址是否正确显示。

二、添加文件到暂存区

Git 提交前必须明确指定哪些文件变更应被纳入本次提交，暂存区（Staging Area）即用于暂存待提交的快照。

1、执行 git status 查看当前工作区文件状态（显示红色未跟踪/已修改文件）。

2、执行 git add . 将所有新增和修改的文件加入暂存区（点号表示当前目录全部）。

3、如仅添加特定文件，可执行 git add 文件名（例如 git add README.md）。

三、提交变更到本地仓库

提交操作将暂存区中的快照永久保存至本地仓库历史记录，并附带描述性信息，便于后续追溯。

1、执行 git commit -m "此处填写简洁明确的提交信息"（英文双引号内不可省略，内容建议用动词开头，如“fix login bug”或“add user validation”）。

2、若提交信息需多行或更详细，可省略 -m 参数，执行后将自动打开默认编辑器供输入。

四、推送到 GitHub 远程仓库

本地提交仅存在于本机，需通过推送操作将提交历史同步至 GitHub，使他人可见并协作。

1、执行 git branch --set-upstream-to=origin/main main 设置本地 main 分支跟踪远程 main 分支（首次推送前建议运行，避免后续报错）。

2、执行 git push -u origin main 推送本地 main 分支到远程 origin，并设置上游分支（-u 参数仅首次需加）。

3、若远程主分支名为 master，将上述命令中 main 替换为 master。

五、处理推送冲突或拒绝

当远程仓库存在本地未获取的提交时，GitHub 可能拒绝直接推送，此时需先整合远程变更再重试。

1、执行 git fetch origin 获取远程最新引用信息（不自动合并）。

2、执行 git merge origin/main 将远程 main 分支变更合并入当前分支（若出现冲突，需手动编辑冲突文件，保存后执行 git add 和 git commit）。

3、执行 git push origin main 再次推送（此时无需 -u 参数）。

好了，本文到此结束，带大家了解了《GitHub提交流程全攻略》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！