GitHub 安装及使用

在程序员的世界里，GitHub 无疑是一个非常重要的平台，而如何上传自己的代码并分享给他人则是其中必须掌握的技能之一。对于初学者来说，上传代码可能会觉得比较困难。所以，本文将为大家介绍如何上传代码到 GitHub。

如果已安装，查找Git在电脑的安装位置

• Mac平台:在命令行中输入which git, 就会显示git的安装位置了;

• Windows平台:打开cmd,输入where git就会显示git的安装路径了

客户端安装

官网下载安装客户端Git - Downloads，一直 next,直到完成.

安装完整，将bin配置至path.

桌面右击，在哪个路径右击打开bash, .git就创建在哪个路径

一、注册GitHub账号

首先，你需要注册一个 GitHub 账号。如果你已经有了账号，可以直接跳过这一步。注册时，需要输入用户名、邮箱地址和密码等信息，同意条款后即可点击 “Sign up for GitHub” 完成注册。

Git的环境配置

• 1、GitHub或Gitee官网上注册一个账号，注册好后，桌面右键选择Git Bash，进行账号配置，命令如下：

# 配置用户名("username"是自己的用户名)

git config --global user.name "username"

# 配置邮箱("username@email.com"是注册账号时所用的邮箱)

git config --global user.email "username@email.com"

执行完以上命令后，可用git config --global --list查看是否配置成功。

2.执行: ssh-keygen -t rsa ，(注意ssh-keygen无空格)，生成SSH(你的电脑与Gitee通信的安全连接)

ssh-keygen -t rsa

3.执行完后到系统盘users目录(win: C:\Users\你的用户名.ssh\），查看生成的ssh文件 

• mac位置 /Users/may/.ssh

may 为用户名，根据实际情况填写 

4.将公钥（ id_rsa.pub），添加到Github或GitLab平台中，这里以GitHub为例

二、创建新的仓库

注册完成后，在 GitHub 页面上右上角的 “+” 号中点击 “New repository” 来创建一个新的仓库。在弹出的新窗口中，输入你的仓库名称，并添加一个简短的描述，选择公开或私有，勾选 “Initialize this repository with a README” 并选择 “MIT License” ，最后点击 “Create repository” 即可完成创建。

三、上传本地代码到 GitHub

在创建完成仓库后，接下来就是上传本地代码到 GitHub 上。先在本地创建一个文件夹作为本地 Git 仓库，然后使用 Git 添加文件并提交。（项目可以优先存放在git文件夹中）

在命令行中，进入本地仓库文件夹中，执行以下命令来添加代码：（提交里的说明根据需要填写）

1 2 3

git init # 初始化本地 Git 仓库 git add . # 添加所有文件至 Git 仓库中 git commit -m "Initial commit" # 提交修改，并添加说明

此时，本地仓库就已经准备好了，接下来需要与 GitHub 上的仓库连接。在仓库页面中，找到仓库地址，如 https://github.com/username/repository.git。

仓库地址查看

在命令行中执行以下命令，将本地仓库推送到 GitHub：

git remote add origin https://github.com/username/repository.git # 关联本地仓库与 GitHub 上的仓库

git branch -M main # 将本地仓库的分支重命名为 main 

git push -u origin main # 将本地仓库推送到 GitHub，第一次执行需要加上 “-u” 参数

git remote add origin https://github.com/username/repository.git

git branch -M main

git push -u origin main

查看是否上传成功：打开git网页，查看仓库是否增加了新推送的文件

最后一步push的常见报错：

情况1. 如果报如下错误：是因为远程仓库和本地仓库文件不同步

解决方法是先执行git pull将远程仓库文件拉下来使得远程与本地同步。

解决步骤：

1）.执行

git pull  webbrowser  master --allow-unrelated-histories

这里的webbrowser换成你的远程仓库名

2）.再次推送

情况2. push时，报错提示：当你在git push到GitHub的时候报错 出现error: remote origin already exists. 翻译过来呢就是 错误:远程源已经存在。

原因：本地git 已经配置了远程仓库地址，所以当 git 再次push到其他的仓库地址时将会提示远程仓库已经存在。

解决方案：

第一: 查看远程库的信息: git remote -v
第二: 删除现有的远程仓库: git remote rm origin
第三: 建立新的远程仓库地址: git remote add origin + 远程仓库地址

四、更新代码

法一、Git Bash方式

在本地对代码进行修改后，需要将代码同步到 GitHub 上，只需要执行以下命令即可：

1 2 3

git add . # 将修改的文件添加到 Git 仓库中 git commit -m "Update code" # 提交修改，并添加说明 git push origin main # 将本地修改的代码推送到 GitHub

总之，通过本文的介绍，我们可以了解到 GitHub 的基本使用方法，从注册账号到创建、上传、更新仓库的全部过程。当然， GitHub 还有很多其他的功能，如协同开发、分支管理等，这些功能有待进一步探索。希望对程序员的小伙伴们能有所帮助。

法二、Git GUI方式

mac版安装git-gui

brew install git-gui

如果安装过程中报错：curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refused

解决方法：

修改hosts，添加一下内容

199.232.28.133 raw.githubusercontent.com

  进入相应的路径后（本地仓库路径），执行git-gui

(windows)在git路径下，右键“Open Git GUI here”

选择要修改的文件，然后点击“Stage Changes”,会加载到左下角的“Stage Changes”模块

添加提交说明，然后点击“Commit”,最后点击“Push”

  

五、时光穿梭机——版本回退

版本回退分为两步骤进行操作：

步骤：

①查看版本，确定需要回到的时刻点

指令：git log

显示操作的人，操作的时间

git log --pretty=oneline

这里就体现出了commit -m"注释内容"时，添加合理注释的重要性。

②回退操作

指令：

git reset --hard

提交编号

案例：想坐时光机回到创建好第一个文件的时候

注意：回到过去之后，要想再回到之前最新的版本的时候，则需要使用指令去查看历史操作，以得到最新的commit id。

指令：git reflog

小结：

a. 要想回到过去，必须先得到commit id，然后通过git reset –hard 进行回退；

b. 要想回到未来，需要使用git reflog进行历史操作查看，得到最新的commit id；

c. 在写回退指令的时候commit id可以不用写全，git自动识别，但是也不能写太少，至少需要写前4位字符；

六、 gui工具客户端

  客户端有很多种：Fork（免费）、GitHub Desktop（免费）、Sourcetree（免费）、Tower（付费）、GitKraken（免费/付费）、Sublime Merge（前期免费）等等

windows有个好用的：TortoiseGit ,下载安装

安装 GitHub Deshtop 

 mac/windows版，安装GitHub Desktop，官网下载：GitHub Desktop