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）添加所有该目录下的文件（所有文件或者指定文件）

# 添加所有文件gitadd.# 添加 指定文件 的文件路径# git add ./<文件名> 例如：gitadd ./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仓库中查看测试用例链接

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