GitHub 项目上传与提交流程详解

本文详细拆解了将本地新项目首次上传至 GitHub 的完整流程，涵盖从初始化仓库、关联远程地址、提交代码到成功推送的五大关键步骤，并特别提醒用户注意 GitHub 已弃用密码认证、需使用个人访问令牌（PAT）替代这一重要安全变更，帮助开发者避开常见坑点，高效开启版本管理与团队协作。

如果您在本地创建了一个新项目，希望将其上传到 GitHub 进行版本管理与协作，则需要完成初始化本地仓库、关联远程仓库、提交代码并推送等操作。以下是具体执行步骤：

一、初始化本地 Git 仓库

在项目根目录中创建 Git 版本控制所需的元数据目录（.git），使该文件夹成为可追踪变更的本地仓库。

1、打开终端（macOS/Linux）或命令提示符/PowerShell（Windows）。

2、使用 cd 命令切换至您的项目根目录，例如：cd /path/to/your/project。

3、执行命令：git init。

二、添加远程 GitHub 仓库地址

将本地仓库与 GitHub 上新建的空仓库建立连接，以便后续推送代码。

1、登录 GitHub 网站，点击右上角 “+” 号，选择 “New repository”。

2、填写仓库名称，保持 “Initialize this repository with a README” 处于未勾选状态（避免冲突），点击 “Create repository”。

3、在新仓库页面，复制顶部显示的远程地址（HTTPS 或 SSH 格式，推荐 HTTPS）。

4、在终端中执行：git remote add origin https://github.com/username/repository-name.git（将链接替换为实际地址）。

三、暂存并提交本地文件

将待上传的文件纳入 Git 暂存区，并生成一次本地版本快照，为推送做准备。

1、执行命令：git add .（将当前目录下所有未忽略文件加入暂存区）。

2、执行命令：git status，确认待提交文件列表无误。

3、执行命令：git commit -m "Initial commit"（引号内为本次提交的简要说明）。

四、推送到 GitHub 远程仓库

将本地提交的历史记录同步至 GitHub 对应的远程分支，完成首次上传。

1、确认当前所在分支为 main 或 master（多数新仓库默认为 main）。

2、执行命令：git branch -M main（如当前分支名非 main，强制重命名为 main）。

3、执行命令：git push -u origin main（-u 参数建立上游跟踪，后续推送可简化为 git push）。

五、处理常见身份验证问题

GitHub 自 2021 年起不再支持密码方式提交，需通过个人访问令牌（PAT）或 SSH 密钥认证。

1、若使用 HTTPS 方式推送失败，访问 GitHub Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token。

2、勾选 repo 权限，生成后复制该令牌。

3、再次执行 git push 时，用户名填写 GitHub 账户名，密码栏粘贴该令牌。

本篇关于《GitHub 项目上传与提交流程详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！