doc: update semver.md. d145aaa0b0

This commit is contained in:
jaywcjlove
2022-10-27 09:33:57 +00:00
parent e301a2b894
commit a37c121cd1

View File

@ -156,8 +156,7 @@
<table class="shortcuts"><thead><tr><th>范围</th><th>描述</th><th>Notes</th></tr></thead><tbody><tr><td><code>~1.2.3</code></td><td><code>>=1.2.3 &#x3C;1.3.0</code></td><td></td></tr><tr><td><code>^1.2.3</code></td><td><code>>=1.2.3 &#x3C;2.0.0</code></td><td></td></tr><tr><td><code>^0.2.3</code></td><td><code>>=0.2.3 &#x3C;0.3.0</code></td><td>(0.x.x 是特殊的)</td></tr><tr><td><code>^0.0.1</code></td><td><code>=0.0.1</code></td><td>(0.0.x 是特殊的)</td></tr><tr><td><code>^1.2</code></td><td><code>>=1.2.0 &#x3C;2.0.0</code></td><td>(像 ^1.2.0)</td></tr><tr><td><code>~1.2</code></td><td><code>>=1.2.0 &#x3C;1.3.0</code></td><td>(像 ~1.2.0)</td></tr><tr><td><code>^1</code></td><td><code>>=1.0.0 &#x3C;2.0.0</code></td><td></td></tr><tr><td><code>~1</code></td><td>相同的</td><td></td></tr><tr><td><code>1.x</code></td><td>相同的</td><td></td></tr><tr><td><code>1.*</code></td><td>相同的</td><td></td></tr><tr><td><code>1</code></td><td>相同的</td><td></td></tr><tr><td><code>*</code></td><td>任何版本</td><td></td></tr><tr><td><code>x</code></td><td>相同的</td><td></td></tr></tbody></table> <table class="shortcuts"><thead><tr><th>范围</th><th>描述</th><th>Notes</th></tr></thead><tbody><tr><td><code>~1.2.3</code></td><td><code>>=1.2.3 &#x3C;1.3.0</code></td><td></td></tr><tr><td><code>^1.2.3</code></td><td><code>>=1.2.3 &#x3C;2.0.0</code></td><td></td></tr><tr><td><code>^0.2.3</code></td><td><code>>=0.2.3 &#x3C;0.3.0</code></td><td>(0.x.x 是特殊的)</td></tr><tr><td><code>^0.0.1</code></td><td><code>=0.0.1</code></td><td>(0.0.x 是特殊的)</td></tr><tr><td><code>^1.2</code></td><td><code>>=1.2.0 &#x3C;2.0.0</code></td><td>(像 ^1.2.0)</td></tr><tr><td><code>~1.2</code></td><td><code>>=1.2.0 &#x3C;1.3.0</code></td><td>(像 ~1.2.0)</td></tr><tr><td><code>^1</code></td><td><code>>=1.0.0 &#x3C;2.0.0</code></td><td></td></tr><tr><td><code>~1</code></td><td>相同的</td><td></td></tr><tr><td><code>1.x</code></td><td>相同的</td><td></td></tr><tr><td><code>1.*</code></td><td>相同的</td><td></td></tr><tr><td><code>1</code></td><td>相同的</td><td></td></tr><tr><td><code>*</code></td><td>任何版本</td><td></td></tr><tr><td><code>x</code></td><td>相同的</td><td></td></tr></tbody></table>
<!--rehype:className=shortcuts--> <!--rehype:className=shortcuts-->
</div></div></div><div class="wrap row-span-3"><div class="wrap-header h3wrap"><h3 id="连字符范围"><a aria-hidden="true" tabindex="-1" href="#连字符范围"><span class="icon icon-link"></span></a>连字符范围</h3><div class="wrap-body"> </div></div></div><div class="wrap"><div class="wrap-header h3wrap"><h3 id="连字符范围"><a aria-hidden="true" tabindex="-1" href="#连字符范围"><span class="icon icon-link"></span></a>连字符范围</h3><div class="wrap-body">
<!--rehype:wrap-class=row-span-3-->
@ -211,7 +210,41 @@
<!--rehype:className=shortcuts--> <!--rehype:className=shortcuts-->
<p>当右侧为部分(例如,<code>2.3</code>)时,假定缺失的部分为<code>x</code>(例如,<code> 2.3.x</code>)。</p> <p>当右侧为部分(例如,<code>2.3</code>)时,假定缺失的部分为<code>x</code>(例如,<code> 2.3.x</code>)。</p>
<p>如果左边是部分的(例如,<code>1.2</code>),则假定缺少的部分为<code>0</code>(例如,<code> 1.2.0</code>)。</p> <p>如果左边是部分的(例如,<code>1.2</code>),则假定缺少的部分为<code>0</code>(例如,<code> 1.2.0</code>)。</p>
</div></div></div></div></div><div class="wrap"><div class="wrap-header h3wrap"><h3 id="组合范围"><a aria-hidden="true" tabindex="-1" href="#组合范围"><span class="icon icon-link"></span></a>组合范围</h3><div class="wrap-body"> </div></div></div></div></div><div class="wrap row-span-4"><div class="wrap-header h3wrap"><h3 id="有效的语义版本"><a aria-hidden="true" tabindex="-1" href="#有效的语义版本"><span class="icon icon-link"></span></a>有效的语义版本</h3><div class="wrap-body">
<!--rehype:wrap-class=row-span-4-->
<pre class="language-js"><code class="language-js code-highlight"><span class="code-line"><span class="token number">0.0</span><span class="token number">.4</span>
</span><span class="code-line"><span class="token number">1.2</span><span class="token number">.3</span>
</span><span class="code-line"><span class="token number">10.20</span><span class="token number">.30</span>
</span><span class="code-line"><span class="token number">1.1</span><span class="token number">.2</span><span class="token operator">-</span>prerelease<span class="token operator">+</span>meta
</span><span class="code-line"><span class="token number">1.1</span><span class="token number">.2</span><span class="token operator">+</span>meta
</span><span class="code-line"><span class="token number">1.1</span><span class="token number">.2</span><span class="token operator">+</span>meta<span class="token operator">-</span>valid
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>alpha
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>beta
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>alpha<span class="token punctuation">.</span><span class="token property-access">beta</span>
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>alpha<span class="token punctuation">.</span><span class="token property-access">beta</span><span class="token punctuation">.</span><span class="token number">1</span>
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>alpha<span class="token punctuation">.</span><span class="token number">1</span>
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>alpha0<span class="token punctuation">.</span><span class="token property-access">valid</span>
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>alpha<span class="token punctuation">.</span>0valid
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>alpha<span class="token operator">-</span>a<span class="token punctuation">.</span><span class="token property-access">b</span><span class="token operator">-</span>c<span class="token operator">-</span>somethinglong<span class="token operator">+</span>build<span class="token punctuation">.</span><span class="token number">1</span><span class="token operator">-</span>aef<span class="token punctuation">.</span><span class="token number">1</span><span class="token operator">-</span>its<span class="token operator">-</span>okay
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>rc<span class="token punctuation">.</span><span class="token number">1</span><span class="token operator">+</span>build<span class="token punctuation">.</span><span class="token number">1</span>
</span><span class="code-line"><span class="token number">2.0</span><span class="token number">.0</span><span class="token operator">-</span>rc<span class="token punctuation">.</span><span class="token number">1</span><span class="token operator">+</span>build<span class="token punctuation">.</span><span class="token number">123</span>
</span><span class="code-line"><span class="token number">1.2</span><span class="token number">.3</span><span class="token operator">-</span>beta
</span><span class="code-line"><span class="token number">10.2</span><span class="token number">.3</span><span class="token operator">-</span><span class="token constant">DEV</span><span class="token operator">-</span><span class="token constant">SNAPSHOT</span>
</span><span class="code-line"><span class="token number">1.2</span><span class="token number">.3</span><span class="token operator">-</span><span class="token constant">SNAPSHOT</span><span class="token operator">-</span><span class="token number">123</span>
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span>
</span><span class="code-line"><span class="token number">2.0</span><span class="token number">.0</span>
</span><span class="code-line"><span class="token number">1.1</span><span class="token number">.7</span>
</span><span class="code-line"><span class="token number">2.0</span><span class="token number">.0</span><span class="token operator">+</span>build<span class="token punctuation">.</span><span class="token number">1848</span>
</span><span class="code-line"><span class="token number">2.0</span><span class="token number">.1</span><span class="token operator">-</span>alpha<span class="token punctuation">.</span><span class="token number">1227</span>
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>alpha<span class="token operator">+</span>beta
</span><span class="code-line"><span class="token number">1.2</span><span class="token number">.3</span><span class="token operator">--</span><span class="token operator">--</span><span class="token constant">RC</span><span class="token operator">-</span><span class="token constant">SNAPSHOT</span><span class="token number">.12</span><span class="token number">.9</span><span class="token number">.1</span><span class="token operator">--</span><span class="token number">.12</span><span class="token operator">+</span><span class="token number">788</span>
</span><span class="code-line"><span class="token number">1.2</span><span class="token number">.3</span><span class="token operator">--</span><span class="token operator">--</span><span class="token constant">R</span><span class="token operator">-</span><span class="token constant">S</span><span class="token number">.12</span><span class="token number">.9</span><span class="token number">.1</span><span class="token operator">--</span><span class="token number">.12</span><span class="token operator">+</span>meta
</span><span class="code-line"><span class="token number">1.2</span><span class="token number">.3</span><span class="token operator">--</span><span class="token operator">--</span><span class="token constant">RC</span><span class="token operator">-</span><span class="token constant">SNAPSHOT</span><span class="token number">.12</span><span class="token number">.9</span><span class="token number">.1</span><span class="token operator">--</span><span class="token number">.12</span>
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">+</span><span class="token number">0</span><span class="token punctuation">.</span><span class="token property-access">build</span><span class="token punctuation">.</span><span class="token number">1</span><span class="token operator">-</span>rc<span class="token punctuation">.</span>10000aaa<span class="token operator">-</span>kk<span class="token operator">-</span><span class="token number">0.1</span>
</span><span class="code-line"><span class="token number">99999999999999999999999.999999999999999999</span><span class="token number">.99999999999999999</span>
</span><span class="code-line"><span class="token number">1.0</span><span class="token number">.0</span><span class="token operator">-</span>0A<span class="token punctuation">.</span><span class="token property-access">is</span><span class="token punctuation">.</span><span class="token property-access">legal</span>
</span></code></pre>
</div></div></div><div class="wrap"><div class="wrap-header h3wrap"><h3 id="组合范围"><a aria-hidden="true" tabindex="-1" href="#组合范围"><span class="icon icon-link"></span></a>组合范围</h3><div class="wrap-body">
@ -231,10 +264,8 @@
<table class="shortcuts show-header"><thead><tr><th>范围</th><th>描述</th></tr></thead><tbody><tr><td><code>>=0.14 &#x3C;16</code></td><td>和 (空格分隔)</td></tr><tr><td><code>0.14.x || 15.x.x</code></td><td>或 (双竖线分隔)</td></tr></tbody></table> <table class="shortcuts show-header"><thead><tr><th>范围</th><th>描述</th></tr></thead><tbody><tr><td><code>>=0.14 &#x3C;16</code></td><td>和 (空格分隔)</td></tr><tr><td><code>0.14.x || 15.x.x</code></td><td>或 (双竖线分隔)</td></tr></tbody></table>
<!--rehype:className=shortcuts show-header--> <!--rehype:className=shortcuts show-header-->
</div></div></div><div class="wrap"><div class="wrap-header h3wrap"><h3 id="预发布"><a aria-hidden="true" tabindex="-1" href="#预发布"><span class="icon icon-link"></span></a>预发布</h3><div class="wrap-body"> </div></div></div><div class="wrap row-span-2"><div class="wrap-header h3wrap"><h3 id="解释"><a aria-hidden="true" tabindex="-1" href="#解释"><span class="icon icon-link"></span></a>解释</h3><div class="wrap-body">
<pre><code class="code-highlight"><span class="code-line">1.2.3-prerelease+build <!--rehype:wrap-class=row-span-2-->
</span></code></pre>
</div></div></div><div class="wrap"><div class="wrap-header h3wrap"><h3 id="解释"><a aria-hidden="true" tabindex="-1" href="#解释"><span class="icon icon-link"></span></a>解释</h3><div class="wrap-body">
@ -262,6 +293,10 @@
<table class="shortcuts"><thead><tr><th>范围</th><th>描述</th></tr></thead><tbody><tr><td><code>^</code></td><td>意思是“兼容”</td></tr><tr><td><code>~</code></td><td>意思是“相当接近”</td></tr><tr><td><code>0.x.x</code></td><td>用于“初始开发”</td></tr><tr><td><code>1.x.x</code></td><td>表示定义了公共 API</td></tr></tbody></table> <table class="shortcuts"><thead><tr><th>范围</th><th>描述</th></tr></thead><tbody><tr><td><code>^</code></td><td>意思是“兼容”</td></tr><tr><td><code>~</code></td><td>意思是“相当接近”</td></tr><tr><td><code>0.x.x</code></td><td>用于“初始开发”</td></tr><tr><td><code>1.x.x</code></td><td>表示定义了公共 API</td></tr></tbody></table>
<!--rehype:className=shortcuts--> <!--rehype:className=shortcuts-->
</div></div></div><div class="wrap"><div class="wrap-header h3wrap"><h3 id="预发布"><a aria-hidden="true" tabindex="-1" href="#预发布"><span class="icon icon-link"></span></a>预发布</h3><div class="wrap-body">
<pre><code class="code-highlight"><span class="code-line">1.2.3-prerelease+build
</span><span class="code-line">1.1.2-prerelease+meta
</span></code></pre>
</div></div></div></div></div><div class="wrap"><div class="wrap-header h2wrap"><h2 id="另见"><a aria-hidden="true" tabindex="-1" href="#另见"><span class="icon icon-link"></span></a>另见</h2><div class="wrap-body"> </div></div></div></div></div><div class="wrap"><div class="wrap-header h2wrap"><h2 id="另见"><a aria-hidden="true" tabindex="-1" href="#另见"><span class="icon icon-link"></span></a>另见</h2><div class="wrap-body">
<ul> <ul>
<li><a href="https://regex101.com/r/vkijKf/1/">语义化版本号验证正则表达式,支持按编号提取的语言</a></li> <li><a href="https://regex101.com/r/vkijKf/1/">语义化版本号验证正则表达式,支持按编号提取的语言</a></li>