GitHub代码上传教程详解

无论你是刚完成本地开发的新手，还是希望高效托管项目并支持团队协作的开发者，这篇教程都为你清晰拆解了将代码上传至 GitHub 的完整路径——从在 GitHub 创建空仓库、本地初始化 Git 仓库、添加与提交文件，到关联远程地址并推送代码，同时贴心提供了命令行和 GitHub Desktop 图形化两种操作方式，兼顾精准控制与操作便捷，助你零障碍迈出开源协作的第一步。

如果您已完成本地代码开发，希望将项目发布到 GitHub 进行版本托管与协作，则需要通过 Git 命令行或 GitHub Desktop 工具完成初始化、提交与推送操作。以下是上传项目的完整流程：

一、创建 GitHub 仓库

在上传代码前，需先在 GitHub 网站上新建一个空仓库，用于接收本地代码推送。该仓库提供唯一的远程地址（HTTPS 或 SSH），是后续关联和同步的基础。

1、登录 GitHub 官网（https://github.com）并进入主界面。

2、点击右上角“+”号，选择 New repository。

3、填写仓库名称（Repository name），可选填写描述（Description）。

4、设置可见性：选择 Public（公开）或 Private（私有）。

5、取消勾选 Initialize this repository with a README（避免远程与本地产生初始冲突）。

6、点击 Create repository 按钮完成创建。

二、初始化本地 Git 仓库

Git 需识别项目根目录为受控仓库，通过 git init 命令生成隐藏的 .git 目录，启用版本追踪能力。

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

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

3、执行命令：git init。

4、终端显示 Initialized empty Git repository in ... 即表示初始化成功。

三、添加文件并提交到本地仓库

Git 默认不自动跟踪文件，需显式告知哪些文件纳入版本管理。暂存（stage）后提交（commit）形成不可变的历史快照。

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

2、如仅添加特定文件，可使用：git add filename.py README.md。

3、执行提交命令：git commit -m "Initial commit"。

4、引号内为提交信息，建议用英文短语准确描述本次变更内容。

四、关联远程仓库并推送代码

本地仓库需绑定 GitHub 上创建的远程仓库地址，才能通过 git push 将提交历史同步过去。

1、复制 GitHub 仓库页面右侧的 HTTPS URL（形如 https://github.com/username/repo-name.git）或 SSH URL（形如 git@github.com:username/repo-name.git）。

2、在终端中执行：git remote add origin https://github.com/username/repo-name.git。

3、验证远程地址是否正确：git remote -v，应显示 origin 对应的 fetch/push 地址。

4、首次推送使用：git push -u origin main（若默认分支为 main）；若为 master 分支，则改用 git push -u origin master。

五、使用 GitHub Desktop 图形化上传

对于不熟悉命令行的用户，GitHub Desktop 提供可视化操作界面，自动处理初始化、暂存、提交与推送全流程，降低操作门槛。

1、从 desktop.github.com 下载并安装 GitHub Desktop。

2、启动应用，使用 GitHub 账户登录。

3、点击 File → Add Local Repository，选择本地项目文件夹。

4、在右侧变更列表中勾选全部文件，输入提交信息，点击 Commit to main。

5、点击右上角 Publish repository，填写仓库名、描述，选择公开性，点击发布。

终于介绍完啦！小伙伴们，这篇关于《GitHub代码上传教程详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！