首先来设置使用 Git 时的姓名和邮箱地址。名字请用英文输入。php
$ git config --global user.name "Firstname Lastname" $ git config --global user.email "your_email@example.com"
这个命令,会在“~/.gitconfig”中以以下形式输出设置文件。linux
[user] name = Firstname Lastname email = your_email@example.com
想更改这些信息时,能够直接编辑这个设置文件。这里设置的姓名和邮箱地址会用在 Git 的 提交日志中。因为在 GitHub 上公开仓库时,这里的姓名和邮箱地址也会随着提交日志一同被公开,因此请不要使用不便公开的隐私信息。git
将 color.ui 设置为 auto 可让命令的输出拥有更高的可读性。github
$ git config --global color.ui auto
“~/.gitconfig”中会增长下面一行。shell
[color] ui = auto
这样一来,各类命令的输出就会变得更容易分辨。bash
注意:下面大多数命令是在Win下 git bash 中使用,固然,linux终端也可使用。框架
GitHub 上链接已有仓库时的认证,是经过使用了 SSH 的公开密钥认证方式进行的。如今让咱们来建立公开密钥认证所需的 SSH Key,并将其添加至 GitHub。ssh
在 Git bash 运行下面的命令建立 SSH Key。编辑器
$ ssh-keygen -t rsa -C "your_email@example.com" Generating public/private rsa key pair. Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa): 按回车键 Enter passphrase (empty for no passphrase): 输入密码 Enter same passphrase again: 再次输入密码
your_email@example.com
的部分请改为您在建立帐户时用的邮箱地址。密码须要在认证时输入,请选择复杂度高而且容易记忆的组合。输入密码后会出现提示已经建立密匙的提示,并告诉存储位置以及相关信息。其中,id_rsa 文件是私有密钥,id_rsa.pub 是公开密钥。ide
在 GitHub 中添加公开密钥(Add SSH Key
),从此就能够用私有密钥进行认证了。
在 Title 中输入适当的密钥名称。Key 部分使用 id_rsa.pub
文件里的内容。id_rsa.pub
的内容能够用以下方法查看。
$ cat ~/.ssh/id_rsa.pub ssh-rsa 公开密钥的内容 your_email@example.com
添加后,帐户邮箱会收到邮件提示。可使用以下命令测试用手中的私人密钥与 GitHub 进行认证和
通讯。
$ ssh -T git@github.com
如果出现
The authenticity of host 'github.com (207.97.227.239)' can't be established. RSA key fingerprint is fingerprint值 . Are you sure you want to continue connecting (yes/no)? 输入yes
出现以下结果即为成功。
Hi hirocastest! You've successfully authenticated, but GitHub does not provide shell access.
Initialize this repository with a README
在 Initialize this repository with a README 选项上打钩,随后GitHub 会自动初始化仓库并设置 README 文件,让用户能够马上clone 这个仓库。若是想向 GitHub 添加手中已有的 Git 仓库,建议不要勾选,直接手动 push。
https://github.com/用户名/Hello-Word
是刚刚建立的仓库的页面。
.gitignore
正如其名,这个设定会帮咱们把不须要在Git仓库中进行版本管理的文件记录在 .gitignore
文件中,省去了每次根据框架进行设置的麻烦。
GitHub Flavored Markdown
在 GitHub 上进行交流时用到的 Issue、评论、Wiki,均可以用 Markdown 语法表述,从而进行标记。准确地说应该是 GitHub Flavored Markdown(GFM)
语法。该语法虽然是 GitHub 在 Markdown 语法基础上扩充而来的,但通常状况下只要按照本来的 Markdown 语法进行描述就能够。
将代码下载到了本地以仓库名做为文件夹名的文件夹中,可是与直接下载不一样。
$ git clone git@github.com:hirocastest/Hello-World.git Cloning into 'Hello-World'... remote: Counting objects: 3, done. remote: Total 3 (delta 0), reused 0 (delta 0) Receiving objects: 100% (3/3), done. $ cd Hello-World
这里会要求输入 GitHub 上设置的公开密钥的密码。认证成功后,仓库便会被 clone 至仓库名后的目录中。将想要公开的代码提交至这个仓库再 push 到 GitHub 的仓库中,代码便会被公开。
若是以前并未设置密码,那么这里也就不用输入。
本地文件想要加入,须要先加到本地仓库。只有添加到其中,才能实现跟踪管理。
这里咱们编写一个 hello_world.php
文件,用来输出“Hello World!”。
因为 hello_word.php 尚未添加至 Git 仓库,因此显示为 Untracked
files。
$ git status # On branch master # Untracked files: # (use "git add <file>..." to include in what will be committed) # # hello_world.php nothing added to commit but untracked files present (use "git add" to track)
添加到本地仓库,这样一来,这个文件就进入了版本管理系统的管理之下。从此的更改管理都交由 Git 进行。经过 git add命令将文件加入暂存区,再经过 git commit
命令附加信息并提交。
$ git add hello_world.php $ git commit -m "Add hello world script by php" [master d23b909] Add hello world script by php 1 file changed, 3 insertions(+) create mode 100644 hello_world.php
添加成功后,能够经过 git log
命令查看提交日志。
$ git log commit d23b909caad5d49a281480e6683ce3855087a5da Author: 你的信息 Date: 你的时间 Add hello world script by php
关于许可:实际使用时,只需将 LICENSE 文件加入仓库,并在README.md 文件中声明使用了何种许可协议便可。使用没有声明许可协议的软件时,以防万一最好直接联系著做者。
以后只要执行 push,GitHub 上的仓库就会被更新。
$ git push Counting objects: 4, done. Delta compression using up to 4 threads. Compressing objects: 100% (2/2), done. Writing objects: 100% (3/3), 328 bytes, done. Total 3 (delta 0), reused 0 (delta 0) To git@github.com:hirocastest/Hello-World.git 46ff713..d23b909 master -> master
要使用 Git 进行版本管理,必须先初始化仓库。
在包含全部要上传的文件的目录级别下:
$ git init
若是初始化成功,执行了 git init
命令的目录下就会生成 .git
目录。这个 .git
目录里存储着管理当前目录内容所需的仓库数据。在 Git 中,咱们将这个目录的内容称为“附属于该仓库的工做树”。文件的编辑等操做在工做树中进行,而后记录到仓库中,以此管理文件的历史快照。
工做树和仓库在被操做的过程当中,状态会不断发生变化。
$ git status # On branch master # # Initial commit # nothing to commit (create/copy files and use "git add" to track)
结果显示了咱们当前正处于 master
分支下。接着还显示了没有可提交的内容。所谓提交(Commit),是指“记录工做树中全部文件的当前状态”。
要想让文件成为 Git 仓库的管理对象,就须要用 git add
命令将其加入暂存区(Stage 或者 Index)中。暂存区是提交以前的一个临时区域。
$ git add README.md $ git status # On branch master # # Initial commit # # Changes to be committed: # (use "git rm --cached <file>..." to unstage) # # new file: README.md #
可见,新建的文件被加到了暂存区(注意关注输出内容中括号中的内容,会有一些功能性的建议)
能够将当前暂存区中的文件实际保存到仓库的历史记录中。经过这些记录,咱们就能够在工做树中复原文件。
$ git commit -m "First commit" [master (root-commit) 9f129ba] First commit 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 README.md
-m
参数后的 "First commit"称做提交信息,是对这个提交的概述。如果不加 -m
,直接执行 git commit
命令。执行后编辑器就会启动,并显示以下结果。
git commit -am "..."
命令一次完成 add,commit。
# Please enter the commit message for your changes. Lines starting # with '#' will be ignored, and an empty message aborts the commit. # On branch master # # Initial commit # # Changes to be committed: # (use "git rm --cached <file>..." to unstage) # # new file: README.md #
在编辑器中记述提交信息的格式以下。
* 第一行:用一行文字简述提交的更改内容 * 第二行:空行 * 第三行之后:记述更改的缘由和详细内容
只要按照上面的格式输入,从此即可以经过确认日志的命令或工具看到这些记录。
在以 #(井号)标为注释的 Changes to be committed(要提交的更改)栏中,能够查看本次提交中包含的文件。将提交信息按格式记述完毕后,请保存并关闭编辑器,以 #(井号)标为注释的行没必要删除。随后,刚才记述的提交信息就会被提交。
若是在编辑器启动后想停止提交,请将提交信息留空并直接关闭编辑器,随后提交就会被停止。
提交以后,工做树状态会提示没有更改,由于处于最新状态。
要修改上一条提交信息,可使用 git commit --amend
命令。
能够查看什么人在何时进行了提交或合并,以及操做先后有怎样的差异。
针对刚才
$ git log commit 9f129bae19b2c82fb4e98cde5890e52a6c546922(指向这个提交的哈希值) Author: ... Date: ... First commit(该提交的提交信息。)
若是只想让程序显示第一行简述信息,能够在 git log
命令后加上 --pretty=short
。
$ git log --pretty=short commit 9f129bae19b2c82fb4e98cde5890e52a6c546922 Author: ... First commit $ git log -p README.md
在 git log
命令后加上 -p
参数,文件的先后差
别就会显示在提交信息以后。加上目录名,便会只显示该目录下的日志。若是加的是文件名,就会只显示与该文件相关的日志。
git log -- graph
——以图表形式查看分支合并提交等信息。
能够查看 工做树、暂存区、最新提交之间的差异。显示的内容的内容中,“+”号标出的是新添加的行,被删除的行则用“-”号标出。
要查看与最新提交的差异,请执行如下
命令。
$ git diff HEAD
这里的 HEAD
是指向当前分支中最新一次提交
的指针。
在进行多个并行做业时,咱们会用到分支。在这类并行开发的过程当中,每每同时存在多个最新代码状态。master
分支是 Git 默认建立的分支,所以基本上全部开发都是以这个分支为中心进行的。不一样分支中,能够同时进行彻底不一样的做业。等该分支的做业完成以后再与 master
分支合并。
git branch
命令能够将分支名列表显示,同时能够确认当前所在分支。
分支左侧标有“*”(星号),表示这是咱们当前所
在的分支。结果中没有显示其余分支名,表示本地仓库中只存在 master
一个分支。
若是想以当前的 master
分支为基础建立新的分支,咱们须要用到 git checkout -b
命令。
$ git checkout -b feature-A Switched to a new branch 'feature-A'
等同于:
$ git branch feature-A $ git checkout feature-A
建立 feature-A
分支,并将当前分支切换为 feature-A
分支。这时再来查看分支列表,会显示咱们处于 feature-A
分支下。
在这个状态下像正常开发那样修改代码、执行 git add
命令并进行提交的话,代码就会提交至 feature-A
分支。
命令 git checkout -
能够切换回上一个分支,固然指定名字也能够。
特性分支顾名思义,是集中实现单一特性(主题),除此以外不进行任何做业的分支。在平常开发中,每每会建立数个特性分支,同时在此以外再保留一个随时能够发布软件的稳定分支。稳定分支的角色一般由 master
分支担当。
主干分支是刚才咱们讲解的特性分支的原点,同时也是合并的终点。一般人们会用 master
分支做为主干分支。主干分支中并无开发到一半的代码,能够随时供他人查看。有时咱们须要让这个主干分支老是配置在正式环境中,有时又须要用标签 Tag 等建立版本信息,同时管理多个版本发布。拥有多个版本发布时,主干分支也有多个。
接下来,咱们假设 feature-A
已经实现完毕,想要将它合并到主干分支 master
中。为了在历史记录中明确记录下本次分支合并,咱们须要建立合并提交。所以,在合并时加上 --no-ff
参数,在主干分支中执行
$ git merge --no-ff feature-A
随后编辑器会启动,用于录入合并提交的信息。默认信息中已经包含了是从 feature-A
分支合并过来的相关内容,因此可没必要作任何更改。将编辑器中显示的内容保存,关闭编辑器会提示成功合并。
合并时可能发生冲突(Conflict),不解决,没法合并。按提示解决就好。
要让仓库的 HEAD
、暂存区、当前工做树回溯到指定状态,须要用到 git rest --hard
命令。只要提供 目标时间点的哈希值,就能够彻底恢复至该时间点的状态。
git log
命令只能查看以当前状态为终点的历史日志。因此这里要使用 git reflog
命令,查看当前仓库的操做日志。在日志中找出回溯历史以前的哈希值,经过 git reset --hard
命令恢复到回溯历史前的状态。
在日志中,咱们能够看到 commit、checkout、reset、merge 等 Git 命令的执行记录。只要不进行 Git 的 GC(Garbage Collection,垃圾回收),就能够经过日志随意调取近期的历史状态。
在合并特性分支以前,若是发现已提交的内容中有些许拼写错误等,不妨提交一个修改,而后将这个修改包含到前一个提交之中,压缩成一个历史记录。
git rebase -i HEAD~2
方式执行 git rebase
命令,能够选定当前分支中包含 HEAD
(最新提交)在内的两个最新历史记录为对象,并在编辑器中打开。
出现相似
pick 7a34294 Add feature-C pick 6fba227 Fix typo
将 6fba227
左侧的 pick
部分删除,改写为 fixup
。
pick 7a34294 Add feature-C fixup 6fba227 Fix typo
保存编辑器里的内容,关闭编辑器。提示 rebase
成功。这样一来,Fix typo
就从历史中被抹去,也就至关于 Add feature-C
中历来没有出现过拼写错误。这算是一种良性的历史改写。
在 GitHub 上新建一个仓库。为防止与其余仓库混淆,仓库名请与本地仓库保持一致。建立时请不要勾选 Initialize this repository with a README
选项。由于一旦勾选该选项,GitHub 一侧的仓库就会自动生成 README 文件,从建立之初便与本地仓库失去了整合性。虽然到时也能够强制覆盖,但为防止这一状况发生仍是建议不要勾选该选项。
如今咱们用 git remote add
命令将github新建仓库设置成本地仓库的远程仓库。
$ git remote add origin 远程仓库路径
按照上述格式执行 git remote add
命令以后,Git 会自动将远程仓库的名称设置为 origin
(标识符)。
当前分支下本地仓库内容推送到远程仓库。
假定在 master
分支下工做。
$ git push -u origin master
当前分支的内容就会被推送给远程仓库 origin
的 master
分支。
-u
参数能够在推送的同时,将 origin
仓库的 master
分支设置为本地仓库当前分支的 upstream
(上游)。添加了这个参数,未来运行 git pull
命令从远程仓库获取内容时,本地仓库的这个分支就能够直接从 origin
的 master
分支获取内容,省去了另外添加参数的麻烦。
对于其余分支,咱们在本地仓库中建立了 feature-D
分支,如今将它 push 给远程仓
库并保持分支名称不变。
$ git checkout -b feature-D $ git push -u origin feature-D
不要与以前操做的仓库在同一目录下。执行 git clone
命令后咱们会默认处于 master
分支下,同时系统会自动将 origin
设置成该远程仓库的标识符。也就是说,当前本地仓库的 master
分支与 GitHub 端远程仓库(origin)的 master
分支在内容上是彻底相同的。
用 git branch -a
命令查看当前分支的相关信息。添加 -a
参数能够同时显示本地仓库和远程仓库的分支信息。
若要获取远程特性分支 feature-D
,可使用以下操做。
$ git checkout -b feature-D origin/feature-D
-b
参数的后面是本地仓库中新建分支的名称。为了便于理解,咱们仍将其命名为 feature-D
,让它与远程仓库的对应分支保持同名。新建分支名称后面是获取来源的分支名称。
例子中指定了 origin/feature-D
,就是说以远程 origin
的仓库的 feature-D
分支做为来源,在本地仓库中建立 feature-D
分支。更改添加提交推送便可。
$ git commit -am "Add feature-D" $ git push
此时,本地分支中并未有内容,须要使用 pull
$ git pull origin feature-D
若是两人同时修改了同一部分的源代码,push 时就很容易发生冲突。因此多名开发者在同一个分支中进行做业时,为减小冲突状况的发生,建议更频繁地进行 push 和 pull 操做。