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

878阅读 · 0评论 · 2018/08/26发布   前往评论

建立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_rsaid_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来删除缓冲,然后进行commitpush,这样会发现远程仓库中的不必要文件就被删除了,以后可以直接使用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即可。


  • 有疑问请在杜赛的个人网站留言,我会尽快回复。
  • 或Email私信我:dusaiphoto@foxmail.com



本文作者: 杜赛
发布时间: 2018年08月26日 - 14:33
最后更新: 2019年01月28日 - 16:40
知识共享许可协议   转载请保留原文链接及作者


登录 后回复

共有0条评论