[toc=2]
# 什么是Git?
* Git是一个分布式版本管理系统
* Git可以在任何时间点,把文档的状态作为更新记录保存起来。
* 可以把编辑过的文档恢复到以前的状态,也可以显示编辑前后的内容差异。
# Git管理的有哪些好处?
* 发布更方便
* 查找更轻松
* 查看文档修改历史,并支持代码回滚
# 安装Git
* 下载[Git](https://git-scm.com/downloads)
* 安装(一直下一步即可)
# 什么是Git分区?
```[sequence]
participant 工作区 as work
participant 暂存区 as stage
participant 本地仓库 as local
participant 远程仓库(看云) as remote
work->stage:$ git add
stage->local:$ git commit
local->remote:$ git push
remote-->work:$ git pull
```
# Git常用命令速查表

# 使用Git管理接口文档
## 设置Git用户名和邮箱
```
$ git config --global user.name "John Doe"
$ git config --global user.email johndoe@example.com
```
## 把看云上的文档下载到本地
> 如果询问用户名和密码, 填上看云的用户名和密码即可
```
$ git clone https://git.kancloud.cn/yanshandou/kam.git
```
## 新增/修改/删除文档并上传到看云
```
$ git add .
$ git commit -m 'this is a commit'
$ git push
```
## 在看云上修改文件并同步到本地
```
$ git pull
```
## 解决本地和看云的文档冲突
```
$ git pull
```
```
修改冲突文件...
```
```
$ git add .
$ git commit -m 'this is a commit'
$ git push
```
## 如何避免冲突
> 先同步再修改
## 使用git查看文档修改历史
```
$ git log --pretty=oneline filename
$ git show 哈希值(最少前四位)
```
## 使用看云查看文档修改历史




## 文档内容回滚
```
$ git reset 哈希值 文件名
$ git commit -m 'commit'
$ git checkout 文件名
$ git push
```
# vscode简化操作
## 新增/修改/删除文档并上传到看云




## 在看云上修改文件并同步到本地


## 解决本地和看云的文档冲突





## 查看文档修改历史
> 安装插件`GitLens`




## 文档内容回滚

# 扩展阅读
* [猴子都能懂的GIT入门](https://backlog.com/git-tutorial/cn/intro/intro1_1.html)
* [Git图解](http://marklodato.github.io/visual-git-guide/index-zh-cn.html?no-svg#basic-usage)
- 打造高逼格接口管理平台
- 开篇
- 课程简介
- 聊聊接口平台
- 接口平台简介
- 优雅的使用看云
- 接口和markdown
- 接口文档版本演进
- 微软的硬菜--vscode
- markdown基础语法
- markdown进阶语法--流程图
- markdown进阶语法--时序图
- markdown进阶语法--API文档
- 接口文档的基本概念
- 接口管理平台的基本元素
- 编写接口文档并且发布更新
- 接口安全
- 文档安全
- 接口安全
- Git化你的文档
- 使用Git管理文档
- 自动化
- 自动化文档更新
- 收尾
- 如何反馈问题
- 课程总结
- 示例
- 更新信息
- 查询历史天气
- markdown语法示例
- 流程图示例
- 时序图示例
- 登录/注册
- 数据字典示例
- 课程问题解答