# CompositionScoringSystemBackup

**Repository Path**: se-g11/CompositionScoringSystemBackup

## Basic Information

- **Project Name**: CompositionScoringSystemBackup
- **Description**: 主仓库备份
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-12-10
- **Last Updated**: 2021-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Quick Start

### 下载到本地

```shell
git clone https://gitee.com/se-g11/CompositionScoringSystem.git
```

### 找不到其他分支？

如果使用 `git branch`查看除了 master 以外的分支，可以考虑以下两个做法。

第一种是使用命令行的形式

```shell
git checkout dev
git checkout feature-doc
git checkout feature-ppt
git checkout feature-meeting
```

第二种是修改`.git/config`的内容，在最下面添加:

```shell
[branch "dev"]
	remote = origin
	merge = refs/heads/dev
[branch "feature-doc"]
	remote = origin
	merge = refs/heads/feature-doc
[branch "feature-ppt"]
	remote = origin
	merge = refs/heads/feature-ppt
[branch "feature-meeting"]
	remote = origin
	merge = refs/heads/feature-meeting
```

本质上，你在下载的时候已经附带来了其他的分支信息，只是 `git branch` 并没有识别出来。

### 设置 up-stream

这个问题主要是在 pull 的时候，git 不知道从哪个分支 pull，因为git的本地仓库的分支名可能和远程仓库的分支名不太一样。

```shell
git branch --set-upstream-to=origin/master master
git branch --set-upstream-to=origin/dev dev
git branch --set-upstream-to=origin/feature-doc feature-doc
git branch --set-upstream-to=origin/feature-ppt feature-ppt
git branch --set-upstream-to=origin/feature-meeting feature-meeting
```

## Git 管理说明

### 分支说明

本项目使用的分支及其解释如下，提交相应的变更的时候请注意。

| 分支名          | 说明                                         |
| --------------- | -------------------------------------------- |
| master          | 主分支，只会保存主版本或者一些重要的子版本。 |
| dev             | 某一开发阶段的主要分支                       |
| feature-doc     | 某一开发阶段编写文档的分支                   |
| feature-ppt     | 某一开发阶段编写PPT的分支                    |
| feature-meeting | 某一开发阶段编写会议记录的分支               |
| ~~beta~~        | 曾经使用过的分支，现已迁移到了dev            |

### 版本号说明

本项目使用的版本号命名规则如下:

​	`.主版本号[.子版本号[.修订号[-修饰词]]]`

- `[]`代表可选的内容。
- 主版本号在第一次彻底完成开发之前都为`0`。
- 子版本号在每一个阶段完成之后加`1`。
- 修订号是在某一阶段开发中完成某些基线之后设立的。
- 一些修饰词说明如下:
	| 修饰词  | 说明   |
	| ------- | ------ |
	| beta    | 测试版 |
	| release | 发行版 |

##### 标签管理

每一个修订号都由对应的 tag 来标记，在 [tag页](https://gitee.com/se-g11/CompositionScoringSystem/tags) 可以看到所有的历史版本。

##### 发行版管理

每一个子版本号都由对应的 release 来标记，在 [release页](https://gitee.com/se-g11/CompositionScoringSystem/releases) 可以看到所有的历史版本。

### 查看项目结构的网络图

1. 使用 Gitee 查看项目的网络图。

   master分支的网络结构图地址: [master 网络图](https://gitee.com/se-g11/CompositionScoringSystem/graph/master)。

   其他分支的网络结构图可以通过左上角的切换分支查看。

2. 使用 VSCode 查看项目的网络图。

   下载 [Git Graph](https://github.com/mhutchie/vscode-git-graph) 插件。

   使用 VSCode 命令面板运行 `Git Graph: View Git Graph(git log) `。

## Git 提交规范

### 常规内容提交

```shell
git add -A
git commit -m [message]
git push origin [branch]
```

| 变量      | 说明                                                         |
| --------- | ------------------------------------------------------------ |
| [message] | 提交信息，要求写出所有变更的内容，对于原来没有的文件，需要标明"新增..."；对已经存在文件的修改，需要标明"更新..."；对删除的文件，需要标明"删除..."。如果有多种类型的提交内容，可以使用`；`隔开。如果内容比较多，推荐使用 vim 来编辑。 |
| [branch]  | 分支名，见上方的分支说明。                                   |

> 直接使用 `git commit`，而不跟后面的内容，可以进入编辑器编辑内容。
>
> 如果使用的默认编辑器不是 vim，可以说使用 `git config --global core.editor vim` 来更改。

### 切换分支

```shell
git checkout [branch]
```

> `[branch]` 的含义同上。

### 更新本地仓库

```shell
git pull
```

要求及时更新，不然会造成仓库的冲突。

### 分支合并: merge和rebase的比较

```shell
# 合并
git merge [branch]
# 同步
git rebase [branch]
```

`rebase `虽然叫同步，但其实是一种合并的优化。

当两个项目 `merge` 的时候， git 的提交记录必定会增加一层，但是 `rebase` 是把指针移动到某一个快照上，而这个过程不会增加新的提交记录。

推荐当合并到主分支的时候使用 `merge` 命令，子分支更新成父分支的当前的内容使用 `rebase` 命令。

### 重命名文件

**0.5.5 新增规范**

当文件名重新命名的时候，git可能会丢失之前的文件追踪记录。

推荐使用 `git mv` 命令给文件重命名。

```shell
git mv [from] [to]
```

| 变量   | 说明                   |
| ------ | ---------------------- |
| [from] | 文件的旧名字，支持路径 |
| [to]   | 文件的新名字，支持路径 |

## 历史追踪

### 查看所有历史

```shell
git log --summary
```

### 使用格式化

```shell
git log --pretty=format:"%h - %s" --summary
```

### 使用搜索

```shell
/项目甘特图
# 使用.通配符
/项目甘特图v3.1..
```

点击 n 可以跳到下一条。

### 解决中文乱码问题

```shell
git config --global core.quotepath false
```

### 使用 grep 进行过滤搜索

```shell
git log --pretty=format:"%h - %s" --summary | grep delete
```

grep 的具体使用教程可以自己找。

### 创建查看分支

用前面几步得到的标识码创建新分支，用来查看。

```shell
git checkout -b watch_1 cee02c8
```

## 其他相关的仓库

- [代码实现](https://gitee.com/se-g11/composition-scoring-system-code)
- [会议记录和访谈](https://gitee.com/se-g11/composition-scoring-system-meeting-record)
- [参考书籍及其他资源](https://gitee.com/se-g11/composition-scoring-system-refs)