feat: add semver.md
cheatsheet.
This commit is contained in:
parent
c7be3f3761
commit
94ea0c0ce8
@ -19,6 +19,7 @@ Quick Reference
|
||||
[npm](./docs/npm.md)
|
||||
[package.json](./docs/package.json.md)
|
||||
[VSCode](./docs/vscode.md)
|
||||
[Semver](./docs/semver.md)
|
||||
[Sketch](./docs/sketch.md)
|
||||
[Jest](./docs/jest.md)
|
||||
<!--rehype:class=home-card-->
|
||||
|
@ -60,13 +60,13 @@ npm install [包名]
|
||||
|
||||
安装后存放位置
|
||||
|
||||
```
|
||||
```bash
|
||||
node_modules/[包名]
|
||||
```
|
||||
|
||||
npmjs 下载地址
|
||||
|
||||
```
|
||||
```bash
|
||||
https://registry.npmjs.org/[包名]/-/[包名]-[version].tgz
|
||||
```
|
||||
<!--rehype:className=wrap-text-->
|
||||
|
114
docs/semver.md
Normal file
114
docs/semver.md
Normal file
@ -0,0 +1,114 @@
|
||||
Semver 备忘清单
|
||||
===
|
||||
|
||||
这个 semver 语义化版本快速参考备忘清单。
|
||||
|
||||
语义化版本标准
|
||||
----
|
||||
|
||||
### 介绍
|
||||
|
||||
[Semver](http://semver.org/) 是一种语义版本控制规范。
|
||||
|
||||
- [语义版本控制规范文档](http://semver.org/) _(semver.org)_
|
||||
- [npm 的语义版本器](https://docs.npmjs.com/cli/v6/using-npm/semver) _(npmjs.com)_
|
||||
|
||||
### Semver
|
||||
|
||||
|
||||
| - | - |
|
||||
|-----------------|------------------------|
|
||||
| `主版本号(MAJOR)` | 当你做了不兼容的 API 修改 |
|
||||
| `次版本号(MINOR)` | 当你做了向下兼容的功能性新增 |
|
||||
| `修订号(PATCH)` | 当你做了向下兼容的问题修正 |
|
||||
<!--rehype:class=table-thead-hide-->
|
||||
|
||||
### 简单范围
|
||||
|
||||
```
|
||||
1.2.3
|
||||
=1.2.3
|
||||
>1.2.3
|
||||
<1.2.3
|
||||
>=1.2.3
|
||||
```
|
||||
|
||||
请注意,后缀版本(`1.2.3-rc1`)不匹配。
|
||||
|
||||
### 范围
|
||||
<!--rehype:wrap-class=row-span-3-->
|
||||
|
||||
<!--rehype:-->
|
||||
| 范围 | 描述 | Notes |
|
||||
| --- | --- | --- |
|
||||
| `~1.2.3` | 是 `>=1.2.3 <1.3.0` | |
|
||||
| `^1.2.3` | 是 `>=1.2.3 <2.0.0` | |
|
||||
| `^0.2.3` | 是 `>=0.2.3 <0.3.0` | (0.x.x 是特殊的) |
|
||||
| `^0.0.1` | 是 `=0.0.1` | (0.0.x 是特殊的) |
|
||||
| `^1.2` | 是 `>=1.2.0 <2.0.0` | (像 ^1.2.0) |
|
||||
| `~1.2` | 是 `>=1.2.0 <1.3.0` | (像 ~1.2.0) |
|
||||
| `^1` | 是 `>=1.0.0 <2.0.0` | |
|
||||
| `~1` | 相同的 | |
|
||||
| `1.x` | 相同的 | |
|
||||
| `1.*` | 相同的 | |
|
||||
| `1` | 相同的 | |
|
||||
| `*` | 任何版本 | |
|
||||
| `x` | 相同的 | |
|
||||
<!--rehype:class=table-thead-hide-->
|
||||
|
||||
### 连字符范围
|
||||
<!--rehype:wrap-class=row-span-3-->
|
||||
|
||||
<!--rehype:-->
|
||||
| 范围 | 描述 |
|
||||
| --- | --- |
|
||||
| `1.2.3 - 2.3.4` | 是 `>=1.2.3 <=2.3.4` |
|
||||
|
||||
#### 部分向右
|
||||
|
||||
| 范围 | 描述 |
|
||||
| --- | --- |
|
||||
| `1.2.3 - 2.3` | 是 `>=1.2.3 <2.4.0` |
|
||||
| `1.2.3 - 2` | 是 `>=1.2.3 <3.0.0` |
|
||||
<!--rehype:class=table-thead-hide-->
|
||||
|
||||
#### 部分向左
|
||||
|
||||
| 范围 | 描述 |
|
||||
| --- | --- |
|
||||
| `1.2 - 2.3.0` | 是 `1.2.0 - 2.3.0` |
|
||||
<!--rehype:class=table-thead-hide-->
|
||||
|
||||
当右侧为部分(例如,`2.3`)时,假定缺失的部分为`x`(例如,` 2.3.x`)。
|
||||
|
||||
如果左边是部分的(例如,`1.2`),则假定缺少的部分为`0`(例如,` 1.2.0`)。
|
||||
|
||||
### 组合范围
|
||||
|
||||
| 范围 | 描述 |
|
||||
| --- | --- |
|
||||
| `>=0.14 <16` | 和 (空格分隔) |
|
||||
| `0.14.x \|\| 15.x.x` | 或 (双竖线分隔) |
|
||||
|
||||
### 预发布
|
||||
|
||||
```
|
||||
1.2.3-prerelease+build
|
||||
```
|
||||
|
||||
### 解释
|
||||
|
||||
| 范围 | 描述 |
|
||||
| --- | --- |
|
||||
| `^` | 意思是“兼容” |
|
||||
| `~` | 意思是“相当接近” |
|
||||
| `0.x.x` | 用于“初始开发” |
|
||||
| `1.x.x` | 表示定义了公共 API |
|
||||
<!--rehype:class=table-thead-hide-->
|
||||
|
||||
|
||||
另见
|
||||
----
|
||||
|
||||
- [语义化版本号验证正则表达式,支持按编号提取的语言](https://regex101.com/r/vkijKf/1/)
|
||||
- [语义化版本号验证正则表达式,支持按组名称提取的语言](https://regex101.com/r/Ly7O1x/3/)
|
@ -1,7 +1,7 @@
|
||||
TOML 备忘清单
|
||||
===
|
||||
|
||||
这是 TOML 格式配置文件语法的快速参考备忘单。
|
||||
这是 TOML 格式配置文件语法的快速参考备忘清单。
|
||||
|
||||
入门
|
||||
----
|
||||
|
Loading…
x
Reference in New Issue
Block a user