Windows 10 环境下安装配置Git并连接到GitHub

15097 views, 2019/01/28 updated Go to Comments

建立Git版本库

安装Git

Git的安装比较简单，进入Git官网的Windows下载地址，安装包就开始自动下载了。

打开exe，按照默认选项安装即可。

完成后在开始菜单里打开Git Bash，弹出一个跟cmd类似的窗口，说明安装成功。

Git配置

首先要配置的名字和Email地址，以后每次进行git操作时才能有据可查。打开Git Bash，输入：

$ git config --global user.name 'your_name'
$ git config --global user.email 'your_email'

接下来我们需要创建版本库（Repository），也就是代码的仓库。这个仓库中的文件Git会进行跟踪，以便日后的数据备份和还原。

随便找一个位置，创建一个文件夹git_repo作为版本库目录：

$ mkdir git_repo

输入cd git_repo进入刚创建文件夹的路径：

$ cd git_repo

再输入指令git init初始化Git，告诉Git这里是一个版本库了：

$ git init
Initialized empty Git repository in E:/django_project/git_repo/.git/

这样就建好了一个空的仓库了。

添加文件到Git库

在git_repo目录中创建一个test.txt，内容随意。

在bash中输入命令git add "file_name"告诉Git需要追踪的文件：

$ git add test.txt

再用命令git commit进行提交：

$ git commit -m "test git"

如果bash打印出下面的文本：

[master 5e04f34] test git
 1 file changed, 1 insertion(+)
 create mode 100644 test.txt

说明版本库已经顺利运行起来了。

Git库连接GitHub

创建SSH Key

首先还是打开Git Bash，创建SSH Key，用于Git和GitHub之间的SSH加密传输：

$ ssh-keygen -t rsa -C 'your_email'

回车后提示输入passphrase，类似于密码，每次于GitHub通信时都会要求输入。

passphrase也可以不用设置，一路回车就好。

完成后会在用户目录里生成.ssh目录，比如说我的在C:\Users\dusai\.ssh，里面包含id_rsa和id_rsa.pub两个文件。

接下来登录GitHub账号，在account/settings中找到SSH and GPG keys，点击NEW SSH key；其中的Title文本框请随便填，Key文本框填入id_rsa.pub中的内容。点击Add SSH key，就完成了SSH key 的添加。

连接GitHub

首先创建版本库。点击GitHub导航栏里的New repository：

在Repository name中输入库名称。这里因为是我的Django搭建博客教程的库，因此输入django_blog_tutorial。

写完后点击Create repository，远程版本库就生成了。

进入库的主页，点击SSH，后面的就是远程库的地址：

根据页面的提示，进入本地刚才创建的库目录git_repo，将本地的Git库和远程仓库关联起来：

git remote add origin git@github.com:stacklens/django_blog_tutorial.git
git push -u origin master

bash中打印出如下字符：

Enumerating objects: 4, done.
Counting objects: 100% (4/4), done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 281 bytes | 140.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To github.com:stacklens/django_blog_tutorial.git
   848cc16..5e04f34  master -> master
Branch 'master' set up to track remote branch 'master' from 'origin'.

则表示本地Git已经顺利连接上了GitHub远程仓库。

以后每次需要提交代码到GitHub时，进入到git仓库文件夹，执行下面的代码：

# 提交当前目录下所以文件
$ git add .

# 提交记录说明 
$ git commit -m "xxx"

# 提交到github
$ git push origin master

请尽情享用吧~

将已有项目接入Git

进入项目目录中git init初始化就可以了，后面的步骤跟新建Git项目差不多。

.gitignore忽略提交规则

在使用Git时，有时候我们可能会希望Git只管理部分的文件，排除掉另外的一些过程文件。这时候就需要在项目根目录下配置.gitignore文件，在其中注明希望排除的文件。

关于.gitignore的使用已经有同学总结得非常详细了，有兴趣的同学看这里：Git忽略提交规则 - .gitignore配置运维总结

这里摘抄了上文中关于忽略规则的说明，方便大家查阅：

#               表示此为注释,将被Git忽略
*.a             表示忽略所有 .a 结尾的文件
!lib.a          表示但lib.a除外
/TODO           表示仅仅忽略项目根目录下的 TODO 文件，不包括 subdir/TODO
build/          表示忽略 build/目录下的所有文件，过滤整个build文件夹；
doc/*.txt       表示会忽略doc/notes.txt但不包括 doc/server/arch.txt

bin/:           表示忽略当前路径下的bin文件夹，该文件夹下的所有内容都会被忽略，不忽略 bin 文件
/bin:           表示忽略根目录下的bin文件
/*.c:           表示忽略cat.c，不忽略 build/cat.c
debug/*.obj:    表示忽略debug/io.obj，不忽略 debug/common/io.obj和tools/debug/io.obj
**/foo:         表示忽略/foo,a/foo,a/b/foo等
a/**/b:         表示忽略a/b, a/x/b,a/x/y/b等
!/bin/run.sh    表示不忽略bin目录下的run.sh文件
*.log:          表示忽略所有 .log 文件
config.php:     表示忽略当前路径的 config.php 文件

/mtk/           表示过滤整个文件夹
*.zip           表示过滤所有.zip文件
/mtk/do.c       表示过滤某个具体文件

被过滤掉的文件就不会出现在git仓库中（gitlab或github）了，当然本地库中还有，只是push的时候不会上传。

需要注意的是，gitignore还可以指定要将哪些文件添加到版本管理中，如下：
!*.zip
!/mtk/one.txt

唯一的区别就是规则开头多了一个感叹号，Git会将满足这类规则的文件添加到版本管理中。为什么要有两种规则呢？
想象一个场景：假如我们只需要管理/mtk/目录中的one.txt文件，这个目录中的其他文件都不需要管理，那么.gitignore规则应写为：：
/mtk/*
!/mtk/one.txt

假设我们只有过滤规则，而没有添加规则，那么我们就需要把/mtk/目录下除了one.txt以外的所有文件都写出来！
注意上面的/mtk/*不能写为/mtk/，否则父目录被前面的规则排除掉了，one.txt文件虽然加了!过滤规则，也不会生效！

----------------------------------------------------------------------------------
还有一些规则如下：
fd1/*
说明：忽略目录 fd1 下的全部内容；注意，不管是根目录下的 /fd1/ 目录，还是某个子目录 /child/fd1/ 目录，都会被忽略；

/fd1/*
说明：忽略根目录下的 /fd1/ 目录的全部内容；

/*
!.gitignore
!/fw/ 
/fw/*
!/fw/bin/
!/fw/sf/
说明：忽略全部内容，但是不忽略 .gitignore 文件、根目录下的 /fw/bin/ 和 /fw/sf/ 目录；注意要先对bin/的父目录使用!规则，使其不被排除。

在使用.gitignore文件后如何删除远程仓库中以前上传的此类文件而保留本地文件 在使用git和github的时候，之前没有写.gitignore文件，就上传了一些没有必要的文件，在添加了.gitignore文件后，就想删除远程仓库中的文件却想保存本地的文件。这时候不可以直接使用git rm directory，这样会删除本地仓库的文件。可以使用git rm -r –cached directory来删除缓冲，然后进行commit和push，这样会发现远程仓库中的不必要文件就被删除了，以后可以直接使用git add -A来添加修改的内容，上传的文件就会受到.gitignore文件的内容约束。

常见错误

1. error: failed to push some refs

push时可能产生的错误。

原因是远程库和本地库不一致。所以需要进行拉一份远程版本回来更新，输入命令：

$ git pull origin master

将远程库合并到本地库，应该就解决了。

2. fatal: Couldn't find remote ref master

pull时可能产生的错误。

原因是远程库中的项目是空的，没有文件，没必要再拉取了。

测试的话可以在远程库中创建README.md，再尝试拉取。

3. Everything up-to-date

push时的提示，告诉你已经最新了，但实际上新文件没有推送上去。

其实不是错误，更多的是可能忘记将新文件加入Git的跟踪范围里去了。

4. The authenticity of host 'github.com (xx.xx.xx.xx)' can't be established

第一次进行远程库连接时出现：

The authenticity of host 'github.com (xx.xx.xx.xx)' can't be established.
RSA key fingerprint is SHA256:.........
Are you sure you want to continue connecting (yes/no)?

这是SSH连接的身份验证警告，不用管它，输入yes即可。