一、Git 安装 ( windows )

Git是当今最流行的版本控制软件，它包含了许多高级工具，第一部分为git安装教程。

1. 下载安装包

点击打开下载页: https://www.git-scm.com/download

选择对应系统，以下以windows为例。

2. 安装 Git

注: 对于不同的git版本安装过程可能会略有差异，但整体步骤均相同

第一步: 首先如下图：点击next

第二步：安装配置文件，需要的选上，next

第三步：选择默认的编辑器，直接用推荐的即可，next

第四步：勾选第二项，这样就可以在cmd中操作，next

第五步：使用默认设置即可，next

第六步：使用默认设置即可，next

第七步：配置行结束标记，保持默认”Checkout”

第八步：在终端模拟器选择页面，默认即可

第九步：开启全部功能, next

第十步：安装完成, next

3. 检证 Git

使用git,桌面快捷方式

查看git版本执行命令 git --version

使用 CMD 执行git, 运行 Ctrl+R

查看git版本执行命令 git --version

二、Git 命令

Git 命令速查表

1. 新建代码库

# 在当前目录新建一个Git代码库
$ git init

# 新建一个目录，将其初始化为Git代码库
$ git init [project-name]

# 下载一个项目和它的整个代码历史
$ git clone [url]

2. 配置

Git的设置文件为 .gitconfig，它可以在用户主目录下（全局配置），也可以在项目目录下（项目配置）。

# 显示当前的Git配置
$ git config --list

# 编辑Git配置文件
$ git config -e [--global]

# 设置提交代码时的用户信息
$ git config [--global] user.name "[name]"
$ git config [--global] user.email "[email address]"

3. 增加/删除文件

# 添加指定文件到暂存区
$ git add [file1] [file2] ...

# 添加指定目录到暂存区，包括子目录
$ git add [dir]

# 添加当前目录的所有文件到暂存区
$ git add .

# 添加每个变化前，都会要求确认
# 对于同一个文件的多处变化，可以实现分次提交
$ git add -p

# 删除工作区文件，并且将这次删除放入暂存区
$ git rm [file1] [file2] ...

# 停止追踪指定文件，但该文件会保留在工作区
$ git rm --cached [file]

# 改名文件，并且将这个改名放入暂存区
$ git mv [file-original] [file-renamed]

4. 代码提交

# 提交暂存区到仓库区
$ git commit -m [message]

# 提交暂存区的指定文件到仓库区
$ git commit [file1] [file2] ... -m [message]

# 提交工作区自上次commit之后的变化，直接到仓库区
$ git commit -a

# 提交时显示所有diff信息
$ git commit -v

# 使用一次新的commit，替代上一次提交
# 如果代码没有任何新变化，则用来改写上一次commit的提交信息
$ git commit --amend -m [message]

# 重做上一次commit，并包括指定文件的新变化
$ git commit --amend [file1] [file2] ...

5. 分支

# 列出所有本地分支
$ git branch

# 列出所有远程分支
$ git branch -r

# 列出所有本地分支和远程分支
$ git branch -a

# 新建一个分支，但依然停留在当前分支
$ git branch [branch-name]

# 新建一个分支，并切换到该分支
$ git checkout -b [branch]

# 新建一个分支，指向指定commit
$ git branch [branch] [commit]

# 新建一个分支，与指定的远程分支建立追踪关系
$ git branch --track [branch] [remote-branch]

# 切换到指定分支，并更新工作区
$ git checkout [branch-name]

# 切换到上一个分支
$ git checkout -

# 建立追踪关系，在现有分支与指定的远程分支之间
$ git branch --set-upstream [branch] [remote-branch]

# 合并指定分支到当前分支
$ git merge [branch]

# 选择一个commit，合并进当前分支
$ git cherry-pick [commit]

# 删除分支
$ git branch -d [branch-name]

# 删除远程分支
$ git push origin --delete [branch-name]
$ git branch -dr [remote/branch]

6. 标签

# 列出所有tag
$ git tag

# 新建一个tag在当前commit
$ git tag [tag]

# 新建一个tag在指定commit
$ git tag [tag] [commit]

# 删除本地tag
$ git tag -d [tag]

# 删除远程tag
$ git push origin :refs/tags/[tagName]

# 查看tag信息
$ git show [tag]

# 提交指定tag
$ git push [remote] [tag]

# 提交所有tag
$ git push [remote] --tags

# 新建一个分支，指向某个tag
$ git checkout -b [branch] [tag]

7. 查看信息

# 显示有变更的文件
$ git status

# 显示当前分支的版本历史
$ git log

# 显示commit历史，以及每次commit发生变更的文件
$ git log --stat

# 搜索提交历史，根据关键词
$ git log -S [keyword]

# 显示某个commit之后的所有变动，每个commit占据一行
$ git log [tag] HEAD --pretty=format:%s

# 显示某个commit之后的所有变动，其"提交说明"必须符合搜索条件
$ git log [tag] HEAD --grep feature

# 显示某个文件的版本历史，包括文件改名
$ git log --follow [file]
$ git whatchanged [file]

# 显示指定文件相关的每一次diff
$ git log -p [file]

# 显示过去5次提交
$ git log -5 --pretty --oneline

# 显示所有提交过的用户，按提交次数排序
$ git shortlog -sn

# 显示指定文件是什么人在什么时间修改过
$ git blame [file]

# 显示暂存区和工作区的差异
$ git diff

# 显示暂存区和上一个commit的差异
$ git diff --cached [file]

# 显示工作区与当前分支最新commit之间的差异
$ git diff HEAD

# 显示两次提交之间的差异
$ git diff [first-branch]...[second-branch]

# 显示今天你写了多少行代码
$ git diff --shortstat "@{0 day ago}"

# 显示某次提交的元数据和内容变化
$ git show [commit]

# 显示某次提交发生变化的文件
$ git show --name-only [commit]

# 显示某次提交时，某个文件的内容
$ git show [commit]:[filename]

# 显示当前分支的最近几次提交
$ git reflog

8. 远程同步

# 下载远程仓库的所有变动
$ git fetch [remote]

# 显示所有远程仓库
$ git remote -v

# 显示某个远程仓库的信息
$ git remote show [remote]

# 增加一个新的远程仓库，并命名
$ git remote add [shortname] [url]

# 取回远程仓库的变化，并与本地分支合并
$ git pull [remote] [branch]

# 上传本地指定分支到远程仓库
$ git push [remote] [branch]

# 强行推送当前分支到远程仓库，即使有冲突
$ git push [remote] --force

# 推送所有分支到远程仓库
$ git push [remote] --all

9. 撤销

# 恢复暂存区的指定文件到工作区
$ git checkout [file]

# 恢复某个commit的指定文件到暂存区和工作区
$ git checkout [commit] [file]

# 恢复暂存区的所有文件到工作区
$ git checkout .

# 重置暂存区的指定文件，与上一次commit保持一致，但工作区不变
$ git reset [file]

# 重置暂存区与工作区，与上一次commit保持一致
$ git reset --hard

# 重置当前分支的指针为指定commit，同时重置暂存区，但工作区不变
$ git reset [commit]

# 重置当前分支的HEAD为指定commit，同时重置暂存区和工作区，与指定commit一致
$ git reset --hard [commit]

# 重置当前HEAD为指定commit，但保持暂存区和工作区不变
$ git reset --keep [commit]

# 新建一个commit，用来撤销指定commit
# 后者的所有变化都将被前者抵消，并且应用到当前分支
$ git revert [commit]

# 暂时将未提交的变化移除，稍后再移入
$ git stash
$ git stash pop

10. 其他

# 生成一个可供发布的压缩包
$ git archive

三、Git 高级

1. Git 工作流程

Workspace：工作区
Index / Stage：暂存区
Repository：仓库区（或本地仓库）
Remote：远程仓库

1.1. 工作区

程序员进行开发改动的地方，是你当前看到的，也是最新的。

平常我们开发就是拷贝远程仓库中的一个分支，基于该分支进行开发。在开发过程中就是对工作区的操作。

1.2. 暂存区

.git目录下的index文件, 暂存区会记录git add添加文件的相关信息(文件名、大小、timestamp…)，不保存文件实体, 通过id指向每个文件实体。可以使用git status查看暂存区的状态。暂存区标记了你当前工作区中，哪些内容是被git管理的。

当你完成某个需求或功能后需要提交到远程仓库，那么第一步就是通过git add先提交到暂存区，被git管理。

1.3. 本地仓库

保存了对象被提交过的各个版本，比起工作区和暂存区的内容，它要更旧一些。

git commit后同步index的目录树到本地仓库，方便从下一步通过git push同步本地仓库与远程仓库的同步。

1.4. 远程仓库

远程仓库的内容可能被分布在多个地点的处于协作关系的本地仓库修改，因此它可能与本地仓库同步，也可能不同步，但是它的内容是最旧的。

2. 更多Git资料

更多Git资料

四、GitLab 说明

1. GitLab 注册/登录

沈阳 GitLab 地址: http://172.18.5.63

1.1. 注册

1.2. 登录

1.3. 项目列表

2. 群组

群组是多个项目的集合

群组就像文件夹一样来管理您的项目

在群组里，你可以管理群组成员对各个项目的访问权限。

2.1. 新建群组

可见等级选择了 Private 该群组和其项目只有其成员能以看到。

群组创建成功

2.2. 新建项目

新建项目 NewProject

2.3. 创建完成

2.4. 为项目创建 README

2.5. 增加群成员 ( 开发者 )

搜索成员, 并赋予开发者权限添加到项目

3. 分支

主干分支:

master：随时可供在生产环境中部署的代码，建议伴有标签（TAG）
develop：每天需要提交和合并的代码，功能逐渐完成的代码开发分支

辅助分支:

feature：新功能分支，辅助develop分支。主要用于实验性且效果不好的代码变更。命名规范：feature-*
release：当基本版本完成，准备提交时到APP Store的等待时间，本分支可以做小BUG的修复。成功通过APP Store审核后，必须合并到Master分支，并记录标签（Tag），如果有BUGfix，则还需合并到Develop分支。此版本的作用是项目二期可以继续在develop分支开始开发。命名规范：release-*
hotfix: 对于线上版本（Master分支）的BUG修改的辅助分支，必须合并回master分支和develop分支。命名惯例：hotfix-*

3.1. 创建开发分支

4. 开发

以下使用 cmd 命令进行提交, 具体开发请结合 IDE 。

4.1. 克隆项目

使用 git clone 命令克隆项目

4.2. 切换到 develop 分支

使用 git branch -r 查看远程分支

使用 git checkout develop 切换到开发分支

4.3. 开发并提交

修改文件内容

使用 git commit -a -m "备注" 命令提交到本地库

多人开发需先 git pull 拉取合并代码

使用 git push 推送到远程 develop 分支

GitLab内切换至 develop 分支

查看提交内容

5. 合并分支

master分支为随时可供在生产环境中部署的代码, develop 可提交合并申请, 由 master 权限人员处理合并操作,

5.1. 请求合并

开发者请求合并分支

填写内容, 指派请求给管理者

5.2. 处理合并请求

master 管理者查看合并请求

master 管理者接受合并请求

6. 标签 ( 版本 )

如果你达到一个重要的阶段，并希望永远记住那个特别的提交快照，你可以使用 git tag 给它打上标签。

五、其他

.gitignore 文件

有时对于 git 项目下的某些文件，我们不需要纳入版本控制，比如日志文件或者 IDE 的配置文件，此时可以在项目的根目录下建立一个隐藏文件 .gitignore，然后在 .gitignore 中写入需要忽略的文件。

忽略文件原则:

1. 忽略操作系统自动生成的文件，比如缩略图等;
2. 忽略编译生成的中间文件、可执行文件等，也就是如果一个文件是通过另一个文件自动生成的，那自动生成的文件就没必要放进版本库，比如Java编译产生的.class文件;
3. 忽略你自己的带有敏感信息的配置文件，比如存放口令的配置文件。

语法规范:

1. 空行或是以#开头的行即注释行将被忽略;
2. 以斜杠 “/” 结尾表示目录;
3. 以星号 “*” 通配多个字符;
4. 以问号 “?” 通配单个字符
5. 以方括号 “[]” 包含单个字符的匹配列表;
6. 以叹号 “!” 表示不忽略(跟踪)匹配到的文件或目录;
7. 可以在前面添加斜杠 “/” 来避免递归;

例子:

# 忽略 .a 文件
*.a
# 但否定忽略 lib.a, 尽管已经在前面忽略了 .a 文件
!lib.a
# 仅在当前目录下忽略 TODO 文件， 但不包括子目录下的 subdir/TODO
/TODO
# 忽略 build/ 文件夹下的所有文件
build/
# 忽略 doc/notes.txt, 不包括 doc/server/arch.txt
doc/*.txt
# 忽略所有的 .pdf 文件 在 doc/ directory 下的
doc/**/*.pdf

node项目例子:

# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*

# Runtime data
pids
*.pid
*.seed
*.pid.lock

# Directory for instrumented libs generated by jscoverage/JSCover
lib-cov

# Coverage directory used by tools like istanbul
coverage

# nyc test coverage
.nyc_output

# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
.grunt

# Bower dependency directory (https://bower.io/)
bower_components

# node-waf configuration
.lock-wscript

# Compiled binary addons (https://nodejs.org/api/addons.html)
build/Release

# Dependency directories
node_modules/
jspm_packages/

# Typescript v1 declaration files
typings/

# Optional npm cache directory
.npm

# Optional eslint cache
.eslintcache

# Optional REPL history
.node_repl_history

# Output of 'npm pack'
*.tgz

# Yarn Integrity file
.yarn-integrity

# dotenv environment variables file
.env

# next.js build output
.next

上述例子来自 github 官方, 更多 .gitignore 模板, 可访问 https://github.com/github/gitignore 获取

本文链接地址: Git 使用教程