超详细 Git创建仓库及上传项目至Github操作（Windows系统）

---

前言

本文对于Windows系统上git的安装及基本使用方法进行简单介绍，并介绍如何使用git将仓库中的项目上传至个人的Github中去。内容参考《第一行代码》以及一些博客。

本文适合新手阅读哦~

---

一、Git下载及安装

打开网站 git下载

下载安装包（直接下载最新版本即可）

安装：不需要额外操作，一直点 next 即可。

二、创建代码仓库

完成Git 安装之后，我们可以在计算机的“开始”中找到Git Bash，点击运行。接下来的操作全部都在Git Bash中完成，它长这个样子：

我们在 “$” 后输入命令，本文关于git的操作都在Git Bash中使用命令行进行~

1.配置身份

这一步是为了让 Git 知道是谁想要提交代码，使用下面的命令分别对用户名和邮箱进行配置，这里输入的用户名和邮箱是你Github账号使用的用户名及邮箱。

示例

$ git config --global user.name "Tony"
$ git config --global user.email "Tony@gmail.com"

如果想检验自己的身份是否已经配置好了，我们可以用相同的命令来检验，但不用输入最后的名字和邮箱：

$ git config --global user.name 
"Tony"
$ git config --global user.email
"Tony@gmail.com"

如果在输入命令回车后，出现了我们的用户名及邮箱，就说明已经配置好了身份，下面就可以建仓库啦~

2.创建本地仓库

找到我们想要放到仓库中的代码文件，并且在Git Bash中cd进去。

比如下图中，我们 cd 进入HelloWorld项目，它包含了该项目中的所有代码文件：

输入命令：

$ git init

这样我们就在HeolloWorld项目中建了仓库，在该文件夹下会生成一个隐藏的.git文件夹，通过 ls -al命令可以查看到：

如果我们想删除这个仓库，就把 .git 文件夹删除即可。

3.提交本地代码

我们现在该把代码放到仓库中去了，这一步也很简单。

首先使用 add命令：

$ git add .

这条命令表示把HelloWorld文件夹中全部内容都添加至仓库，如果我们只想添加某个文件或文件夹，就在add 后面加文件名，如下：

$ git add app

用这样的命令，我们就只将app文件夹添加到了仓库中。

此时还没有完成我们的代码提交，只是把需要提交的代码添加了进来，下面用commit 命令完成提交：

$ git commit -m "First commit"

-m 参数用来添加该次提交的描述信息，必须要添加，否则被认为不合法。在这里我们可以写一些版本信息等。

至此，我们完成了建立仓库、向仓库提交代码的过程。

三、使用Git上传代码至Github

通过上面的操作，我们仅仅是完成了在本地建立一个仓库，把代码放了进去。如果我们希望自己Github账号上能同步这个仓库，那就需要接着添加几个步骤了~

1.创建ssh keys

首先确定自己建立了ssh keys，可以通过命令查看：

$ cd ~/.ssh

如果直接跳进文件夹了，那就可以跳过该步骤，直接进入第2步：在Github中新建仓库。

如果显示不存在这个文件，我们就需要创建一个：

$ ssh-keygen -t rsa -C "你的邮箱名"

这个邮箱名就是你Github的注册邮箱。

在执行这条命令后，会依次出现：

$ 指定目录: C:\deskbook\（说明：若在此处不输入路径，而直接按回车，则ssh keys生成后存放的路径为C:\User\.ssh）

$ 输入密码: 123456

$ 确认密码: 123456

它会让你指定目录并输入密码，这个目录可以不指定直接回车，密码自己新设置一个。

这样就创建好了，此时可以再用前面的命令来查看是否正确创建完成。

2.在Github中新建仓库

首先，我们要为自己的Github添加ssh key，来和本地进行关联。我们使用命令进入刚创建好的.ssh中：

$ cd ~/.ssh

里面有一个id_rsa.pub文件，我们可以使用vim打开它，把里面的全部内容复制出来。

接下来进入自己的Github主页，在Settings中，选择SSH and GPG keys，然后再点击右上角添加新密钥按钮New SSH key：

把刚才复制的东西粘贴进Key中，Title自己随便取一个。

这样就完成了SSH Keys的添加，接下来创建仓库：

登录Github账号，在里面使用New repository 新建一个仓库，并命名。

3.关联本地仓库与Github仓库

这一步，要将前面建好的本地仓库和这个Github仓库关联起来

我们进入建好的Github仓库中，找到它的 HTTPS 值并复制下来：

接着我们回到Git Bash中，仍然cd 进入HelloWorld项目文件夹，并执行以下命令：

$ git remote add origin "https://github.com/lijianyi1997/NorwegianWood.git"

这里origin后面就粘贴刚才复制的HTTPS值。

这样，我们完成了两个仓库的关联！

4.推送代码至Github仓库

这是最后一步啦！将本地仓库的代码推送至Github仓库（远程仓库）

$ git push -u origin master

最后这个 master 是上传至Github的分支名。

现在Github好像因为种族歧视问题，把默认的显示分支从master 更改为了 main，所以我们也可以将这一步的命令改为：

$ git push -u origin main

这样打开Github上的仓库时，就可以直接看到你上传的文件，不然的话需要切换分支才能看到，就像这样：

需要切换到master分支，才能看到刚才上传的文件。

---

补充：

我们在Github中往往会给项目建一个ReadMe文件（README.md），在有需要的时候会想在里面插入图片，我们无法将图片直接复制进去，而是需要通过给定相对路径的方式来插入。

这里给一个在ReadMe中插图的方法链接，实测好用：
github readme 怎么添加图片

在写README.md时，插入图片的格式为（全部英文输入）：

![](这里填图片的path)

---

总结

至此我们就完成了：本地建仓库 -> 将内容同步至远程仓库 的整个过程，这是使用Git与Github管理代码的基本操作，确实很方便哦~跟着操作一遍就熟悉啦