# 工具教程文档

## Apifox文档

> Apifox官网：https://apifox.com/help/api-docs/api-design



## Git文档

### 下载Git

> 官网下载：https://git-scm.com/downloads

![image-20240516094921562](assets/image-20240516094921562.png)

进入官网后，根据系统情况，选择对应系统版本软件。如：windows系统

![image-20240516095056288](assets/image-20240516095056288.png)

点击 Windows 后，进入下载详情页。根据系统的情况选择：

![image-20240516095225754](assets/image-20240516095225754.png)

### 安装Git

1、找到下载的文件，鼠标双击进行安装

![image-20240516100919184](assets/image-20240516100919184.png)

2、打开的第一个页面是安装前的使用说明，直接点击**Next**

![img](assets/f86a840c83c84a1a9f1e725d109984cc.png)

3、选择安装地址（可自定义），选好点击**Next**

![img](assets/9a2c426551e240ed819c43864cff887d.png)

4、选择安装组件，选择好后点击**Next**

![img](assets/8372bc66d1fc405c8e21e0ac628cfe48.png)

> - 第一个框是选择是否创建桌面快捷方式，根据自己的需求勾选
> - 第二个框Chek…updates 是每天检查是否有更新，Add…Terminal是添加Git Bash到Windows终端，也是根据个人需求选择
> - 红框外的是默认选择，不要动！！！

5、创建 ”开始菜单“ 目录， 即左下角windows菜单目录名称，一般不用改，直接点击**Next**

![img](assets/e4fe451f064d437e82680e73bb309747.png)

6、编辑器选择，选择默认行即可，点击**Next**

![img](assets/e5869daa333246feab4a58945cadbe91.png)

7、初始化分支命名，选择默认即可，点击**Next**

![img](assets/c856bb4d20404983b92c15a6445ca148.png)

8、选择PATH环境，点击**Next**

![img](assets/ada37f8d081444b388b557499b4fc69b.png)

> 第一种配置是“仅从Git Bash使用Git”。这是最安全的选择，因为您的PATH根本不会被修改。您只能使用 Git Bash 的 Git 命令行工具。但是这将不能通过第三方软件使用；
>
> 第二种配置是“从命令行以及第三方软件进行Git”。该选项被认为是安全的，因为它仅向PATH添加了一些最小的Git包装器，以避免使用可选的Unix工具造成环境混乱；
>
> 您将能够从Git Bash，命令提示符和Windows PowerShell以及在PATH中寻找Git的任何第三方软件中使用Git。这也是推荐的选项。
> 第三种配置是“从命令提示符使用Git和可选的Unix工具”。警告：这将覆盖Windows工具，如 “ find 和 sort ” 只有在了解其含义后才使用此选项 。

9、可执行文件选择，选择Git自带，点击**Next**

![img](assets/bb59db7ec33d41d19282efc3df0a83ba.png)

10、传输方式选择，默认选择HTTPS方式，点击**Next**

![img](assets/1d852853e88f4bed80a945ee35a3617b.png)

11、配置行尾符号转换，默认选择即可，点击**Next**

![img](assets/80a37bbb3b2d4207b04e9aa5dea94f10.png)

> 第一个选项是“签出Windows风格，提交Unix风格的行尾”。签出文本文件时，Git会将LF转换为CRLF。提交文本文件时，CRLF将转换为LF。对于跨平台项目，这是Windows上的推荐设置（“ core.autocrlf”设置为“ true”）；
>
> 第二个选项是“按原样签出，提交Unix样式的行尾”。签出文本文件时，Git不会执行任何转换。 提交文本文件时，CRLF将转换为LF。对于跨平台项目，这是Unix上的建议设置（“ core.autocrlf”设置为“ input”）；
>
> 第三种选项是“按原样签出，按原样提交”。当签出或提交文本文件时，Git不会执行任何转换。不建议跨平台项目选择此选项（“ core.autocrlf”设置为“ false”）。

12、终端模拟器配置，默认选择即可，点击**Next**

![img](assets/767a4734e7cc4a2cb6d90de64acf58a1.png)

13、git pull 什么时候应该什么做，默认选择即可，点击**Next**

![img](assets/a35e6d220f024d548adf2a0c94994ced.png)

14、配置凭据助手，默认选择即可，点击**Next**

![img](assets/48c47ebdb9304b83baf785e6d4c1a310.png)

15、配置额外的选项，默认选择即可，点击**Next**

![img](assets/bf38e1ed59d1462091a8c8adb033ce35.png)

16、实验选项配置，默认即可，点击 **Install** 进行安装

![img](assets/4b93128f016f466d967cea204c1c77d9.png)

17、安装完成，点击**Finish**

![img](assets/529ab2c78576419ab92c62ab46a8d943.png)

18、测试是否安装成功

键盘同时点击 **win + R** 打开 **运行窗口**，输入 **cmd** 打开终端

![image-20240516104454384](assets/image-20240516104454384.png)

在终端输入以下命令，查看Git版本

```shell
git --version
```

![image-20240516104743223](assets/image-20240516104743223.png)

显示出版本信息后，则代表 **git 安装成功**。

### 常用Git命令

#### git配置

首次使用git时，需要进行一定的git配置，命令如下：

```shell
git config --global user.name '你的用户名'
git config --global user.email '你的邮箱'
```

#### 初始化一个仓库

Git使用git init命令来初始化一个Git仓库，执行完git init命令后，会生成一个.git目录，该目录包含了资源数据，且只会在仓库的根目录生成。

```shell
git init	
```

> 打开终端，在需要git管理的目录下，输入该条指定，则可以将该目录初始化为一个git仓库，由git进行管理。

#### 查看仓库内文件的状态

我们可以使用 git status 命令来查看相关文件的状态，直接执行如下命令：

```shell
git status
```

#### 添加文件到缓存

当我们新增或修改仓库内的文件后，首先需要执行 git add 命令，将修改后的文件提交到缓存仓库内，执行命令如下：

```shell
git add .
```

#### 提交缓存仓库中的文件

当缓存仓库存在文件时，则可以执行 git commit 命令，将里面的文件提交到本地仓库中，执行命令如下：

```shell
git commit -m "提交日志，可以写具体改动什么"
```

#### 上传远程仓库

当我们需要本地仓库同步到远程仓库的时候，就可以执行 git push 命令，将本地仓库上传到远程仓库中，执行命令如下：

```shell
git push 远程仓库地址 分支名称（如：master）
```

#### 拉取远程仓库

当远程仓库发生改变后，本地仓库需要进行同步，则可以执行 git pull 命令，将远程仓库同步到本地仓库中，执行命令如下：

```shell
git pull 远程仓库地址 分支名称（如：master）
```

#### 查看当前分支

```shell
git branch
```



## Gitee文档

> 官网地址：https://gitee.com/?utm_source=baidu&utm_medium=sem&utm_term=git&utm_campaign=enterprise&utm_content=competition&wl_kwid=578968257442&wl_creativeid=72303581219&wl_groupid=8116246653&wl_planid=105450754&wl_kw=git&wl_userid=25441451&wl_crowdid=0&wl_src=baidu&bd_vid=9512981433456871971

### 登录

> 未存在账号，需先注册gitee账号，然后进行登录

### 创建仓库

完成登录操作后，如图所示，开始创建仓库

![image-20240516112228167](assets/image-20240516112228167.png)

创建仓库

![image-20240516112534410](assets/image-20240516112534410.png)

创建完成

![image-20240516112733120](assets/image-20240516112733120.png)

### 任务

1、创建本地仓库，新建一个 txt文件

1. 文件名为：班级名称 +  小组序号 + 小组名

2. 文件内容为：小组中每个成员的信息

   格式：学号，姓名，性别，角色身份

   如：10010，张三，男，PM

   ​		10011，莉丝，女，TL

2、将该文件上传到远程仓库中