初次在cmd使用git命令上传项目至github方法(笔记)

在一切开始之前，先推荐一个git简易工具书——Git_Cheat_Sheet，非常适合新手。自行搜索即可，也有热心者提供了中文版。

一、下载 Git

1. 从Git官网下载Git安装包
   
   https://git-scm.com/downloads
   
   注意不要下成 GUI，点击官网首页电视里的下载即可。
   
   

2. 双击安装包安装
   
   根据自己的需要配置，若是一直点下一步也没有问题。

二、配置 Git 环境变量（可选）

配置环境变量后，打开 cmd 输入 git 便可直接运行。但直接使用 git-bash 也是不错的选择。

我的 git 安装完成后就自己配置好了环境变量。如果没有自动配置的话，可以找到 git 安装路径下的 cmd 文件夹（默认为C:\Program Files\Git\cmd)，复制该路径。

将改路径添加至系统环境变量。打开文件资源管理器，右键点击左侧的此电脑->属性->高级系统设置->环境变量->在下方系统变量中找到 path ->选中 path 并选择编辑->新建->将刚才的路径复制到其中->保存退出。

三、生成并配置 SSH 密匙

1. 系统生成 SSH 密匙
   
   打开 git-bash，这里要执行三条命令。

   git config –global user.name "你的用户名"
   
   git config –global user.email "你的@邮箱.com"
   
   ssh-keygen -t rsa -C "你的@邮箱.com"

前两条配置很重要，每次 Git 提交时都会引用这两条信息，说明是谁提交了更新，所以会随更新内容一起被永久纳入历史记录。可用 git config --list 来查看已有配置。

第三条配置用来生成密匙，提示的是给 key 配置一个 password，可以为空，所以按三次回车，不设置密码，之后正常情况下就会生成成功。

SSH 公钥和私钥都被保存在提示的文件夹中，我们需要的是公钥id_rsa.pub

1. 在 github 中配置 SSH 密匙
   
   打开 github 并登陆，点开右上角个人头像，打开 Settings。选择左边 SSH and GPG keys 标签，在 SSH Keys 一栏右边点击 New SSH Key。

title自行填写，key将id_rsa.pub里面的公钥完整的复制粘贴进来

点击 Add SSH Key，然后多了一个 SSH key，添加成功。

四、上传项目至 github

1. 初始化本地仓库
   
   打开终端，选择一个文件夹作文本地仓库，进入该文件夹下，执行命令：git init

返回 “Reinitialized existing Git repository in 文件路径” 即为初始化成功。

1. 将你的 github 远程端连接到本地仓库
   
   （首次连接远程仓库不必要）查看当前的远程库。执行命令：git remote -v

可以查看当前的远程库及其对应的克隆地址。

添加一个远程库。要添加一个新的远程仓库，可以指定一个简单的名字，以便将来引用。执行：

git remote add [库名] [仓库网络地址]

Example: git remote add Planegame https://github.com/coolbooksir/Vue-Navigation-components.git

仓库网络地址可在github仓库中的Clone or Download中复制。

1. 将远程端版本合并到本地版本中
   
   由于是首次执行，本地版本甚至没有 master 分支，需要更新本地版本使之与远端同步。执行命令：git pull [库名] master

即可将远端的 master 分支合并到本地。若无这一步，系统会报以下错误：

error: src refspec master does not match any.

error: failed to push some refs to '仓库网络地址'

PS:此步骤会生成一个 .git 文件夹用来做版本控制；另外会有一个 .gitignore 文件，用来排除一些不想上传的文件。

1. 向 git 添加文件
   
   将你想上传的文件放置于当前文件夹下，执行命令：
   
   git add 或者 git add .
   
   以此来添加单个文件或一次添加所有文件。之后可执行 git status 命令来检查你刚才添加的文件是否确实添加到位。

2. 提交刚才添加的文件到本地版本库，并加上注释
   
   执行命令：git commit -m "注释信息"

该注释信息是你这次版本更新的备注信息，最终会显示在 github Repository 文件列表对应的项目后。

1. 将本地仓库内容上传
   
   执行命令：git pull -u [库名] master (分支名)

输入github的账号密码后，系统返回上传进度，上传成功。

若步骤3未及时执行，会导致版本冲突，报错如下：

! [rejected] master -> master (non-fast-forward)

error: failed to push some refs to 'git@github.com:BIUSekale/test.git'

hint: Updates were rejected because the tip of your current branch is behind

hint: its remote counterpart. Integrate the remote changes (e.g.

hint: 'git pull ...') before pushing again.

hint: See the 'Note about fast-forwards' in 'git push --help' for details.

可以在步骤6时执行强制上传命令：git pull -u [库名] master -f

但是原来网络端master分支的文件会被全部替换，要谨慎使用。所以也可以选择重新 git init 重头再来。