把本地项目第一次上传到GitHub

前言

本博客适用于第一次把本地项目上传到 GitHub。

本博客适用于小白。

如有不正确的地方，欢迎指正。

准备工作

• 本地下载了 Git
• Github 已经注册了账号

操作步骤

     1.  首先在Github上创建一个资源库 new repository 

     2.  打开本地项目目录，空白处右键 Git Bash Here

     3.  执行命令 git config --global user.name "username"

a)  username 替换成你自己的 GitHub 的 Name：GitHub 中 Settings -> Profile -> Name

b)  此命令设置全局的用户名

c)  --global 添加即为设置全局的，可不添加 

     4. 执行命令 git config --global user.email "email"

a)  email替换成你自己的 GitHub 的 Email：GitHub 中 Settings -> Emails

b)  此命令设置全局的邮箱

c)  --global 添加即为设置全局的，可不添加

     5.  执行命令 ssh-keygen -t rsa -C "email"

a)  email替换成你自己的 GitHub 的 Email：GitHub 中 Settings -> Emails

b)  此命令会在计算机用户（c:/用户/name/）新建一个 .ssh文件夹，文件夹下有两个文件

   （id_rsa：私钥 / id_rsa.pub：公钥） 

     6.  执行命令 git init 

a)  特别注意，执行此命令前先把该目录的项目备份一下，看到有网友说因为执行了该命令把文件遗失的情况，

     小心为好

b)  此命令会在该目录新建一个 .git 文件夹

c)  .git 文件夹记录着配置信息，一般不会手动修改

     7.  执行命令 git config core.longpaths true 

a)  此命令防止文件名过长而导致提交失败 

     8.  执行命令 git add -A 

a)  此命令会把该目录中的项目添加到缓存中

     9.  执行命令 git commit -m '提交描述信息' 

a)  命令会把缓存中的文件提交到本地仓库 

到此步骤时，已经把项目提交到了本地仓库，后续操作是把本地仓库提交到 GitHub 上

有两种方式，方式1：使用公钥，方式2：使用账号密码  （使用哪一种方式都可以）

当在 GitHub 上新建了一个仓库后，我们可以发现，此仓库会有两个url，一个是HPPTS，一个是SSH，这两个 url 分别就对应了两种不同的提交验证方式，HTTPS -> 账号密码，SSH -> 公钥

执行下面的命令前可以先观察一下 .git 文件夹下的 config 文件，里面包含了该本地仓库与 GitHub 的验证方式，目前只有[core] 配置，当执行了下面的指令，可以再打开看一下添加了哪些配置

---

下面两种方式选择其一即可！！！ 

---

   方式1（公钥）： 

     10.  执行命令 git remote add origin git@github.com:yourName/yourRepo.git

a)  此命令执行后告诉了该目录的 .git 验证是通过公钥方式 

b)  这时步骤五生成的公钥就要配置到 GitHub 账号里面 

c)  配置方式：① id_rsa.pub->公钥（要全部复制 ）② github -> Settings -> SSH and GPG keys ->

                        new SSH key  -> title随意，key粘贴

     11.  执行命令 git push -u origin master 

a)  此命令就把本地仓库的代码全部提交到 GitHub 了 

   方式2（账号密码）：

      12.  执行命令 git remote add origin https://github.com/yourName/yourRepo.git

a)  此命令执行后告诉了该目录的 .git 验证是通过账号密码方式 

      13.  执行命令 git push -u origin master

a)  输入此命令回车后会弹框让你输入账号密码

b)  登录成功后本地仓库的代码就全部提交到 GitHub 了

c)  我们可以在 win10 管理凭据里面看到一条新凭据 

d)  如何打开win10管理凭据：控制面板 -> 用户账户 -> 管理Windows凭据 -> 普通凭据列表

可能遇到的问题

     1.  在设置全局的用户名称和邮箱时报错，这时输入 git config --list 指令查看一下，当前可能被你设置了多个

          user.name或者多个 user.email，解决方式：

git config --global --replace-all user.email "输入你的邮箱"
git config --global --replace-all user.name "输入你的用户名"

     2. 上传大于 100M 文件时报错

a)  在 .git 目录执行命令 git lfs install  (下载并安装 Git 命令行扩展。)

b)  执行命令 git lfs track "文件夹或文件"（选择希望 Git LFS 管理的文件）

c)  执行命令 git add .gitattributes（添加 .gitattributes 文件）

d)  执行命令 git add -A（把 Git LFS 管理的文件和 .gitattributes 文件添加到缓存中）

e)  执行命令 git commit -m '描述'（提交到本地仓库）

f)  执行命令 git push -u origin master（提交到 GitHub）

参考文档：https://git-lfs.github.com/

 

希望能够帮助到你

over