GitHub 上传代码全流程教程

需完成初始化、关联、暂存、提交和推送五步：一、cd项目目录后git init；二、GitHub建库并git remote add origin ；三、git add .暂存文件；四、git commit -m "描述"；五、首次git push -u origin main，后续git push。

如果您已完成本地代码开发，希望将其发布到 GitHub 远程仓库进行版本管理与协作，则需完成初始化、关联、暂存、提交和推送等标准 Git 操作。以下是执行此任务的完整流程：

一、创建并初始化本地 Git 仓库

在存放代码的文件夹中启用 Git 版本控制，使该目录成为可跟踪变更的工作区。

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

2、运行 git init 命令，生成 .git 子目录，完成本地仓库初始化。

二、将本地仓库与 GitHub 远程仓库建立连接

通过添加远程地址，使本地 Git 能够识别并同步至指定的 GitHub 仓库。

1、登录 GitHub 网站，点击右上角 “+” 号，选择 “New repository”，填写仓库名称，取消勾选 “Initialize this repository with a README”，点击 “Create repository”。

2、在新仓库页面复制顶部显示的远程 URL（HTTPS 或 SSH 格式）。

3、在本地终端中执行 git remote add origin <远程URL>，例如：git remote add origin https://github.com/username/repo-name.git。

三、暂存待提交的文件

Git 要求先将修改后的文件显式加入暂存区（Staging Area），才能被纳入下一次提交记录。

1、运行 git status 查看当前工作区中未跟踪或已修改的文件列表。

2、对单个文件执行 git add 文件名，例如：git add main.py。

3、对全部文件执行 git add .（注意末尾英文句点），将所有未暂存变更加入暂存区。

四、提交暂存内容到本地仓库

提交操作会将暂存区快照永久保存至本地仓库历史，形成一个具有唯一哈希值的版本节点。

1、运行 git commit -m "描述性提交信息"，例如：git commit -m "add user login function"。

2、确保提交信息简洁明确，避免使用空消息或模糊词汇如 “update”、“fix”。

五、推送本地提交至 GitHub 远程仓库

将本地分支的历史记录上传至远程仓库，使他人可通过网络访问最新代码版本。

1、首次推送时执行 git push -u origin main（若主分支名为 main）；若为老版本默认分支则使用 master。

2、后续推送只需运行 git push 即可同步最新提交。

3、若遇到权限错误，请确认已配置 SSH 密钥或 GitHub Personal Access Token，并检查远程 URL 是否为 HTTPS 且含有效认证凭据。