Github上传指南

上传Github指南

一、准备工作

1、注册Github

没有Github账户的自行到Github官网进行账号的注册，已有账户请跳过直接进入下一步骤 或者 直接跳转到自己正在的阶段进行参考。

github.com

由于国内用户有可能在访问GitHub官网时经常出现无法连接服务器的问题，这里推荐一款浏览器的扩展，来帮助访问加速。

适用于 Google 、Edge 等浏览器，扩展商店直接搜索 github 加速 ,找到 GH Access Master - GitHub科学上网专用工具，安装扩展之后，进行登录就可以免费使用。

注意：注册时推荐使用 Google邮箱，其他邮箱大概率会显示 无效Email地址 之类的提示。没有谷歌邮箱自行注册，这里不再多说。

2、安装git客户端

官网下载对应的安装包 Git - 下载 (git-scm.com)

根据自己电脑的Windows系统选择相对应的安装包，我的是64位的，所以这里选择 64-bit进行下载。

下载完成后，双击安装包，第一个页面选择 Next

之后选择自己想要安装的位置，然后点击 Next

这里选择默认配置，直接 Next

继续 Next

下面步骤新版Git会让用户决定是否自定义分支名称，这里不建议自定义，直接 Next

调整PATH环境，这里推荐第二种配置，然后Next

这里解释下原因：
第一种配置 是 只在Git Bash中使用Git ，并不修改系统的 path环境。显然这是最安全的，但是这也就意味着在以后的Git使用过程中，只能通过 Git Bash的命令行工具进行操作，无法使用其他的第三方软件。

第二种配置 是 从命令行以及第三方使用Git。这种配置方案会在 Path 环境中添加一个最小的Git安装包，所以也是比较安全的。并且可以在 PowerShell或者命令提示符使用 Git，具有很强的便捷性。

第三种配置 是 从命令符提示使用Git和可选的Unix工具。这里官方也是发出了警告 ：该选项将会覆盖Winodws工具，例如 find 和 sort ，只有在理解他的含义之后才推荐选择这个选项。

选择SSH执行文件，推荐使用Git自带的SSH，外部的SSH需要自己另行安装，并且使用Git在环境变量 Path 中找到他们才可使用。

继续选择 Next

配置实验性选项，因其是实验性功能，具有不稳定性，容易出现一些bug，这里全不选，直接 install，开始最后的安装。

等待安装结束。安装成功后可以在菜单开始界面看到如下

至此，上传Github文件的准备工作就已完成。接下来开始进入重要的上传项目阶段。

二、上传Github

1、创建Git仓库

1）登录至自己的GitHub账户，进行仓库的创建

点击 + ，选择 New respository 创建新的仓库

进行仓库信息配置

仓库名：必须填写，描述可填可不填；

仓库性质：可以选择是否分享自己的仓库内容。

Public 即为公开自己的仓库，他人可从你的该仓库进行复制分享内容；

Private 即是将仓库设置为私人仓库，他人无权进入该仓库进行查看赋值分享等操作；

许可证：可选择 None 不添加许可，即仓库内容不开源；若选择项目开源，也可选择比较通用的 GPL 、MIT 许可，当然也选择其他许可，根据自己的需求而定。

分支名称：前面下载Git时，已经配置过分支名称为 master，所以这必须要保持一致。可在 setting 处进行修改。

修改完成后，点击创建仓库，仓库创建完毕。如图

2）设置仓库的访问链接

进入刚刚创建的仓库，点击上方的 setting，下拉找到 Pages ,将其修改为当前的主分支 master，之后保存 Save 。

3) 绑定GitHub用户

打开已经下载好的 Git Bash.exe，进行用户名和邮箱的绑定。

用户名、 邮箱 是注册Github账户时自己设定的。

git config --global user.name "<用户名>"

git config --global user.email "<邮箱地址>"

4）为GitHub账户设置SSH Key

首先检查是否已经有密钥文件生成，仍旧在 Git Bash.exe 中使用下面语句进行查询。

cd ~/.ssh

如果没有密钥生成，回车之后会给出如下提示：

bash: cd: /c/Users/<计算机用户名>/.ssh: No such file or directory

此时可以使用密钥生成指令来生成文件：

ssh-keygen -t rsa -C "<绑定的邮箱地址>"

命令执行过程中，会出现三次选项：

第一次：确认文件生成路径，直接回车；

第二次：设置密码，直接回车。这里直接跳过，不使用密码登录。

第三次：再次确认密码，直接回车。

此时再次使用下面命令进行密钥检查，发现有两个文件名出现。表示密钥生成完成。

cjh@CJH MINGW64 ~
$ cd ~/.ssh

cjh@CJH MINGW64 ~/.ssh
$ ls
id_rsa  id_rsa.pub

来到文件生成目录下，打开 id_rsa.pub文件（使用Sublime Text 或者 笔记本都可以），将里面的一串代码全部复制下来。

密钥复制后，我们进入自己的Github账户，找到 SSH and GPG keys 配置ssh密钥。

Title可随意设置。这里个人为了方便区分，将其与仓库名保持一致。Key处粘贴上刚刚复制的代码即可。然后保存 Add SSH key，即配置完成。后面会跳转一次页面，输入自己的GitHub登录密码即可，之后SSH key密钥便添加完成。如图：

2、将本地仓库与远程仓库继续链接

1) 管理本地仓库

找到想要上传的文件目录，进入该文件内，右键点击 Open Git Bash here，输入指令 git init，将该目录变成 Git 可以管理的本地仓库。

git init

可以看到提示：这是一个空的目录。并且自动生成一个 .git的 隐藏文件夹。

这里最好再次关联一下自己的用户名和邮箱。

git config --global user.name "<用户名>"

git config --global user.email "<邮箱地址>"

2）关联GitHub仓库

进入前面创建好的Github仓库，点击右边的 Code 按钮，找到仓库的地址，进行复制。

在 git 上执行命令，进行远程仓库与本地管理仓库的关联。

# origin后面的地址换成自己的仓库地址
git remote add origin https://github.com/Grim-man/***.git 

3、上传项目文件至Github远程仓库

1）添加所有该目录下的文件（所有文件或者指定文件）

# 添加所有文件
git add .

# 添加 指定文件 的文件路径
# git add ./<文件名> 例如：
git add ./abc.text

2）添加提交命令（提交记录的内容可随意）

# ""内部可随意书写
git commit -m "提交记录"

3）提交文件推送

此时由于该目录还是空目录，所以在第一次推送时的指令需要注意 必须要在 push 后加上 -u，等后续远程仓库中有内容之后，再次进行上传时就不需要了。

# 空目录上传
git push -u origin master

# 后续上传
git push origin master

成功示例：

Git上传指令参考

指令	作用
git init	使当前目录成为可管理的本地仓库
git config --global user.name "用户名"	绑定GitHub用户名
git config --global user.email "邮箱地址"	绑定GitHub邮箱地址
git remote add origin GitHub远程仓库地址	将 可管理的本地仓库 与 远程仓库相关联
git add <文件路径>	添加指定文件到仓库
git commit -m "提交信息"	添加提交记录信息
git push -u origin master	空仓库第一次提交指令
git push origin master	仓库提交指令

2023.11.23更新
之前有人纠结上传文件的路径究竟是使用相对路径还是绝对路径，经过测试发现：
相对路径 和 绝对路径 都可以正常上传，无需纠结。只要确保文件的路径准确无误、提供的路径可以使文件被识别到即可。
可到本人下面提供的GitHub仓库中查看测试用例链接

按照本题顺序操作，基本不会出现问题，如存在其他疑难杂症，其关注其他文章进行解决，本题不做问题统计。