Github——git本地仓库建立与远程连接（最详细清晰版本！附简化步骤与常见错误）
- 2025-05-03 23:42:46
前提概要： github进不去？图片显示不出来？ 有没有更简单的github上传方式？！ 戳这里←←←←
文章目录
一、git简介二、git下载三、git安装3.1 config设置（增删改查）
四.github与git连接——本地Git仓库4.1 建本地的版本库4.2 源代码放入本地仓库4.3提交仓库
五、github与git的连接——通过ssh-key远程连接5.1 创建SSH Key5.2 github填写SSH Key5.3验证5.5 github建仓库5.6 关联远程仓库5.7本地内容上传推送
六、总结步骤与常见错误6.1 步骤6.2 常见错误（不断更新中）
一、git简介
Git是一个开源的分布式版本控制系统，可以有效、高速的处理从很小到非常大的项目版本管理。
二、git下载
2.1下载地址 Git客户端官网下载链接：https://git-scm.com/downloads 选择适合自己本机的版本下载。
三、git安装
3.1安装
双击“Git-2.17.0-64-bit.exe”，进入安装导向界面，点击Next> 选择安装路径，next> next-> 开始菜单快捷方式目录，默认配置即可，点击Next> 选择默认的编辑器：Vim，点击Next> 选择命令行工具，一般选择: User Git from Git Bash only，点击Next> 接下来一路next>，直至install，安装完成。 3.2 配置 计算机右键-属性： 为方便后续应用和验证是否安装成功，配置环境变量配置path (本步骤可不做) cmd输入“git --version”，出现版本信息即安装成功。
3.1 config设置（增删改查）
设置username 和 email
$ git config --global user.name "name"//自定义用户名
$ git config --global user.email "youxiang@qq.com"//用户邮箱
修改
git config --global configname configvalue
查询
git config --global configname
查询全部
git config --list
四.github与git连接——本地Git仓库
4.1 建本地的版本库
等同于新建一个空文件夹 进入，右键-Git Bash-输入“git init”初始化成一个Git可管理的仓库 这时文件夹里多了个.git文件夹，它是Git用来跟踪和管理版本库的。 如果你看不到，需要设置一下让隐藏文件可见。
4.2 源代码放入本地仓库
把项目/源代码粘贴到这个本地Git仓库里面 git status：查看当前的状态
红字表示未add到Git仓库上的文件绿字表示已add到Git仓库上的文件
然后通过git add把项目/源代码添加到本地仓库暂存区 （“git add .” ：把该目录下的所有文件添加到仓库，注意点“.”）
可以看到，查询状态后文件已经变为绿色，说明add成功
4.3提交仓库
用git commit把项目提交到仓库。 -m 后面引号里面是本次提交的注释内容，可以不写，但最好写上，不然会报错
git commit -m "first commit"
五、github与git的连接——通过ssh-key远程连接
本地Git仓库和GitHub仓库之间的传输是通过SSH加密传输的，所以需要配置ssh key。
5.1 创建SSH Key
在用户主目录下，查询是否存在“.ssh”文件。 本机用户主目录为图中所示路径：
如果有，再看文件下有没有id_rsa和id_rsa.pub这两个文件，如果也有，可直接到下一步。如果没有，在开始附录里找到Git Bash，输入命令，创建SSH Key 输入：$ ssh-keygen -t rsa -C "youxiang@qq.com" 引号内是github注册使用的邮箱!!加粗样式
红色三行出现时，直接回车即可。 再查看.ssh时，已经有“id_rsa”，“id_rsa.pub”文件。 SSH Key的秘钥对：id_rsa是私钥，不能泄露；id_rsa.pub是公钥，可以公开。 我们要使用的是其中的公钥id_rsa.pub
5.2 github填写SSH Key
打开“Account settings”–“SSH Keys”页面 点击“Add SSH Key” title自定义，key复制id_rsa.pub的全部内容到文本框中
5.3验证
①验证是否成功，在git bash里输入下面的命令
$ ssh -T git@github.com
②初次设置需要输入yes，出现第二个红框内容表示成功。
5.5 github建仓库
建立一个名称为“Elegent”仓库，这里不要勾选initialize，否则后面可能报错。
5.6 关联远程仓库
根据创建好的Git仓库页面的提示（找自己仓库的提示代码），可以在本地Elegent仓库的命令行输入：
git remote add origin https://github.com/xu-xiaoya/Elegent.git
5.7本地内容上传推送
关联好之后我们就可以把本地库的所有内容推送到远程仓库（也就是Github）上了，通过在Bash输入：
由于新建的远程仓库是空的，所以要加上-u这个参数 git push -u origin master之后仓库不是空的，就不用加上-u git push origin master
上传项目的过程可能需要等一段时间……
…… …………………… perfect！中途弹了个窗让我授权登录github，问题不大~ 这个时候进入github仓库，就可以看到新加的文件
六、总结步骤与常见错误
6.1 步骤
初始化：本地建库（即文件夹），git init添加到仓库：代码文件放入本地库，git add .提交： git commit -m “注释内容”，提交到仓库新建远程仓库并关联：在Github上设置好SSH密钥后，新建一个远程仓库， git remote add origin https://github.com/xu-xiaoya/Elegent.git关联推送：git push (-u) origin master，把本地仓库的代码推送到远程仓库Github上
6.2 常见错误（不断更新中）
①问题一：新建远程仓库的时候勾选Initialize this repository with a README，推送时可能会报failed to push some refs to https://github.com/xu-xiaoya/Elegent.git的错。
解决方案：这是由于你新创建的那个仓库里面的README文件不在本地仓库目录中，这时可以同步内容。
$ git pull --rebase origin master
之后再进行git push origin master就能成功了。
