doc: Update npm.md. 075b69e9ed

docs/npm.html

@@ -41,7 +41,7 @@
 <p>这个 npm 快速参考备忘单显示了它的常用命令使用清单。</p>
 </div></header><div class="menu-tocs"><div class="menu-btn"><svg aria-hidden="true" fill="currentColor" height="1em" width="1em" viewBox="0 0 16 16" version="1.1" data-view-component="true">
   <path fill-rule="evenodd" d="M2 4a1 1 0 100-2 1 1 0 000 2zm3.75-1.5a.75.75 0 000 1.5h8.5a.75.75 0 000-1.5h-8.5zm0 5a.75.75 0 000 1.5h8.5a.75.75 0 000-1.5h-8.5zm0 5a.75.75 0 000 1.5h8.5a.75.75 0 000-1.5h-8.5zM3 8a1 1 0 11-2 0 1 1 0 012 0zm-1 6a1 1 0 100-2 1 1 0 000 2z"></path>
-</svg></div><div class="menu-modal"><a aria-hidden="true" class="leve2 tocs-link" href="#常用命令">常用命令</a><a aria-hidden="true" class="leve3 tocs-link" href="#包管理">包管理</a><a aria-hidden="true" class="leve3 tocs-link" href="#安装名称">安装名称</a><a aria-hidden="true" class="leve3 tocs-link" href="#清单">清单</a><a aria-hidden="true" class="leve3 tocs-link" href="#更新">更新</a><a aria-hidden="true" class="leve3 tocs-link" href="#杂项功能">杂项功能</a><a aria-hidden="true" class="leve3 tocs-link" href="#更改包裹可见性">更改包裹可见性</a><a aria-hidden="true" class="leve3 tocs-link" href="#要将包转移到-npm-用户帐户">要将包转移到 npm 用户帐户</a><a aria-hidden="true" class="leve3 tocs-link" href="#取消发布包">取消发布包</a><a aria-hidden="true" class="leve3 tocs-link" href="#发布包-npmjsorg">发布包 npmjs.org</a><a aria-hidden="true" class="leve2 tocs-link" href="#配置">配置</a><a aria-hidden="true" class="leve3 tocs-link" href="#npmrc">.npmrc</a><a aria-hidden="true" class="leve3 tocs-link" href="#配置内容">配置内容</a><a aria-hidden="true" class="leve3 tocs-link" href="#npmignore">.npmignore</a><a aria-hidden="true" class="leve3 tocs-link" href="#中国镜像站安装">中国镜像站安装</a><a aria-hidden="true" class="leve4 tocs-link" href="#electronjs-镜像和缓存">electronjs 镜像和缓存</a><a aria-hidden="true" class="leve3 tocs-link" href="#身份验证相关配置">身份验证相关配置</a><a aria-hidden="true" class="leve2 tocs-link" href="#另见">另见</a></div></div><div class="h1wrap-body"><div class="wrap h2body-exist"><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">
+</svg></div><div class="menu-modal"><a aria-hidden="true" class="leve2 tocs-link" href="#常用命令">常用命令</a><a aria-hidden="true" class="leve3 tocs-link" href="#包管理">包管理</a><a aria-hidden="true" class="leve3 tocs-link" href="#安装">安装</a><a aria-hidden="true" class="leve3 tocs-link" href="#清单">清单</a><a aria-hidden="true" class="leve3 tocs-link" href="#缓存-cache">缓存 cache</a><a aria-hidden="true" class="leve3 tocs-link" href="#更新">更新</a><a aria-hidden="true" class="leve3 tocs-link" href="#杂项功能">杂项功能</a><a aria-hidden="true" class="leve3 tocs-link" href="#更改包裹可见性">更改包裹可见性</a><a aria-hidden="true" class="leve3 tocs-link" href="#要将包转移到-npm-用户帐户">要将包转移到 npm 用户帐户</a><a aria-hidden="true" class="leve3 tocs-link" href="#取消发布包">取消发布包</a><a aria-hidden="true" class="leve3 tocs-link" href="#发布包-npmjsorg">发布包 npmjs.org</a><a aria-hidden="true" class="leve2 tocs-link" href="#配置">配置</a><a aria-hidden="true" class="leve3 tocs-link" href="#npmrc">.npmrc</a><a aria-hidden="true" class="leve3 tocs-link" href="#配置内容">配置内容</a><a aria-hidden="true" class="leve3 tocs-link" href="#npmignore">.npmignore</a><a aria-hidden="true" class="leve3 tocs-link" href="#中国镜像站安装">中国镜像站安装</a><a aria-hidden="true" class="leve4 tocs-link" href="#electronjs-镜像和缓存">electronjs 镜像和缓存</a><a aria-hidden="true" class="leve3 tocs-link" href="#身份验证相关配置">身份验证相关配置</a><a aria-hidden="true" class="leve2 tocs-link" href="#另见">另见</a></div></div><div class="h1wrap-body"><div class="wrap h2body-exist"><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">
 <!--rehype:body-class=cols-2-->
 </div></div><div class="h2wrap-body cols-2"><div class="wrap h3body-not-exist"><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">
 
@@ -93,10 +93,10 @@
 
 
 
-<table class="auto-wrap"><thead><tr><th>命令</th><th>描述</th></tr></thead><tbody><tr><td><code>npm i</code></td><td><code>npm install</code>的别名</td></tr><tr><td><code>npm install</code></td><td>安装 package.json 中的所有内容</td></tr><tr><td><code>npm install --production</code></td><td>安装 package.json 中的所有内容，除了 devDependecies</td></tr><tr><td><code>npm install lodash</code></td><td>安装一个包</td></tr><tr><td><code>npm install --save-dev lodash</code></td><td>安装为 devDependency</td></tr><tr><td><code>npm install --save-exact lodash</code></td><td>准确安装</td></tr><tr><td><code>npm install @scope/package-name</code></td><td>安装一个作用域的公共包</td></tr><tr><td><code>npm install &#x3C;package_name>@&#x3C;tag></code></td><td>使用 dist-tags 安装包</td></tr><tr><td><code>npm install -g &#x3C;package_name></code></td><td>全局安装包</td></tr><tr><td><code>npm uninstall &#x3C;package_name></code></td><td>卸载包</td></tr></tbody></table>
+<table class="auto-wrap"><thead><tr><th align="left">命令</th><th align="left">描述</th></tr></thead><tbody><tr><td align="left"><code>npm init -y</code></td><td align="left">创建 <code>package.json</code> 文件</td></tr><tr><td align="left"><code>npm install</code> 或 <code>npm i</code></td><td align="left">安装 <code>package.json</code> 中的所有内容</td></tr><tr><td align="left"><code>npm install --production</code></td><td align="left">安装 <code>package.json</code> 中的所有内容 <br> <em>(除了 <code>devDependecies</code>)</em></td></tr><tr><td align="left"><code>npm install lodash</code></td><td align="left">安装一个包</td></tr><tr><td align="left"><code>npm install --save-dev lodash</code></td><td align="left">安装为 <code>devDependency</code></td></tr><tr><td align="left"><code>npm install --save-exact lodash</code></td><td align="left">准确安装</td></tr><tr><td align="left"><code>npm install @scope/package-name</code></td><td align="left">安装一个作用域的公共包</td></tr><tr><td align="left"><code>npm install &#x3C;package_name>@&#x3C;tag></code></td><td align="left">使用 <code>dist-tags</code> 安装包</td></tr><tr><td align="left"><code>npm install -g &#x3C;package_name></code></td><td align="left">全局安装包</td></tr><tr><td align="left"><code>npm uninstall &#x3C;package_name></code></td><td align="left">卸载包</td></tr></tbody></table>
 <!--rehype:class=auto-wrap-->
-<p><code>--save</code> 是 npm@5 的默认值。 以前，使用不带 <code>--save</code> 的 <code>npm install</code> 不会更新 package.json。</p>
-</div></div></div><div class="wrap h3body-not-exist"><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 h3body-not-exist 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">
+<!--rehype:wrap-class=row-span-3-->
 
 
 
@@ -154,8 +154,19 @@
 
 
 
-<table class="auto-wrap"><thead><tr><th>命令</th><th>描述</th></tr></thead><tbody><tr><td><code>npm i sax</code></td><td>NPM 包</td></tr><tr><td><code>npm i sax@latest</code></td><td>指定标签“最新”</td></tr><tr><td><code>npm i sax@3.0.0</code></td><td>指定版本 <code>3.0.0</code></td></tr><tr><td><code>npm i sax@">=1 &#x3C;2.0"</code></td><td>指定版本范围</td></tr><tr><td><code>npm i @org/sax</code></td><td>范围内的 NPM 包</td></tr><tr><td><code>npm i user/repo</code></td><td>GitHub</td></tr><tr><td><code>npm i user/repo#master</code></td><td>GitHub</td></tr><tr><td><code>npm i github:user/repo</code></td><td>GitHub</td></tr><tr><td><code>npm i gitlab:user/repo</code></td><td>GitLab</td></tr><tr><td><code>npm i /path/to/repo</code></td><td>绝对路径</td></tr><tr><td><code>npm i ./archive.tgz</code></td><td>压缩包</td></tr><tr><td><code>npm i https://site.com/archive.tgz</code></td><td>通过 HTTP 压缩包</td></tr></tbody></table>
+<table class="auto-wrap"><thead><tr><th align="left">命令</th><th align="left">描述</th></tr></thead><tbody><tr><td align="left"><code>npm i sax</code></td><td align="left"><code>NPM</code> 包</td></tr><tr><td align="left"><code>npm i sax@latest</code></td><td align="left">指定标签 <code>最新</code></td></tr><tr><td align="left"><code>npm i sax@3.0.0</code></td><td align="left">指定版本 <code>3.0.0</code></td></tr><tr><td align="left"><code>npm i sax@">=1 &#x3C;2.0"</code></td><td align="left">指定版本范围</td></tr><tr><td align="left"><code>npm i @org/sax</code></td><td align="left">范围内的 <code>NPM</code> 包</td></tr><tr><td align="left"><code>npm i user/repo</code></td><td align="left">GitHub</td></tr><tr><td align="left"><code>npm i user/repo#master</code></td><td align="left">GitHub</td></tr><tr><td align="left"><code>npm i github:user/repo</code></td><td align="left">GitHub</td></tr><tr><td align="left"><code>npm i gitlab:user/repo</code></td><td align="left">GitLab</td></tr><tr><td align="left"><code>npm i /path/to/repo</code></td><td align="left">绝对路径</td></tr><tr><td align="left"><code>npm i ./archive.tgz</code></td><td align="left">压缩包</td></tr><tr><td align="left"><code>npm i https://site.com/archive.tgz</code></td><td align="left">通过 <code>HTTP</code> 压缩包</td></tr></tbody></table>
 <!--rehype:class=auto-wrap-->
+<p>安装依赖的可用参数</p>
+<ul class="style-arrow">
+<li><code>-P</code>, <code>--save-prod</code> 包将出现在您的依赖项中，这是默认值(npm v8)，除非存在 <code>-D</code> 或 <code>-O</code></li>
+<li><code>-D</code>, <code>--save-dev</code> 包会出现在你的 <code>devDependencies</code> 中</li>
+<li><code>-O</code>, <code>--save-optional</code> 包将出现在您的 <code>optionalDependencies</code> 中</li>
+<li><code>--no-save</code> 防止保存到依赖项</li>
+<li><code>-E</code>, <code>--save-exact</code> 依赖项将使用精确的版本进行配置，而不是使用 <code>npm</code> 的默认 <a href="./semver.html"><code>semver</code></a> 范围运算符</li>
+<li><code>-B</code>, <code>--save-bundle</code> 依赖项也将添加到您的 <a href="./package.json.html#bundleddependencies"><code>bundleDependencies</code></a> 列表中</li>
+</ul>
+<!--rehype:className=style-arrow-->
+<p>命令 <code>npm i</code> 是 <code>npm install</code> 的别名</p>
 </div></div></div><div class="wrap h3body-not-exist"><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">
 
 
@@ -182,8 +193,16 @@
 
 
 
-<table class="auto-wrap"><thead><tr><th>命令</th><th>描述</th></tr></thead><tbody><tr><td><code>npm list</code></td><td>列出此软件中所有依赖项的已安装版本</td></tr><tr><td><code>npm list -g --depth 0</code></td><td>列出所有全局安装包的安装版本</td></tr><tr><td><code>npm view</code></td><td>列出此软件中所有依赖项的最新版本</td></tr><tr><td><code>npm outdated</code></td><td>仅列出此软件中已过时的依赖项</td></tr></tbody></table>
+<table class="auto-wrap"><thead><tr><th align="left">命令</th><th align="left">描述</th></tr></thead><tbody><tr><td align="left"><code>npm list</code></td><td align="left">列出此软件中所有依赖项的已安装版本</td></tr><tr><td align="left"><code>npm list -g --depth 0</code></td><td align="left">列出所有全局安装包的安装版本</td></tr><tr><td align="left"><code>npm view</code></td><td align="left">列出此软件中所有依赖项的最新版本</td></tr><tr><td align="left"><code>npm outdated</code></td><td align="left">仅列出此软件中已过时的依赖项</td></tr></tbody></table>
 <!--rehype:class=auto-wrap-->
+</div></div></div><div class="wrap h3body-not-exist"><div class="wrap-header h3wrap"><h3 id="缓存-cache"><a aria-hidden="true" tabindex="-1" href="#缓存-cache"><span class="icon icon-link"></span></a>缓存 cache</h3><div class="wrap-body">
+<pre class="language-bash"><code class="language-bash code-highlight"><span class="code-line"><span class="token function">npm</span> cache <span class="token function">add</span> <span class="token operator">&#x3C;</span>package-spec<span class="token operator">></span>    <span class="token comment"># 将指定的包添加到本地缓存</span>
+</span><span class="code-line"><span class="token function">npm</span> cache clean <span class="token punctuation">[</span><span class="token operator">&#x3C;</span>key<span class="token operator">></span><span class="token punctuation">]</span>         <span class="token comment"># 删除缓存文件夹中的所有数据</span>
+</span><span class="code-line"><span class="token function">npm</span> cache <span class="token function">ls</span> <span class="token punctuation">[</span><span class="token operator">&#x3C;</span>name<span class="token operator">></span>@<span class="token operator">&#x3C;</span>version<span class="token operator">></span><span class="token punctuation">]</span>
+</span><span class="code-line"><span class="token function">npm</span> cache verify <span class="token comment"># 验证缓存文件夹的内容，垃圾收集任何不需要的数据，</span>
+</span><span class="code-line">                 <span class="token comment"># 并验证缓存索引和所有缓存数据的完整性</span>
+</span></code></pre>
+<p>用于添加、列出或清理 npm 缓存文件夹</p>
 </div></div></div><div class="wrap h3body-not-exist"><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">
 
 
@@ -214,7 +233,7 @@
 
 
 
-<table><thead><tr><th>命令</th><th>描述</th></tr></thead><tbody><tr><td><code>npm version &#x3C;version></code></td><td>要更改 <code>package.json</code> 中的版本号</td></tr><tr><td><code>npm update</code></td><td>更新生产包</td></tr><tr><td><code>npm update --dev</code></td><td>更新开发包</td></tr><tr><td><code>npm update -g</code></td><td>更新全局包</td></tr><tr><td><code>npm update lodash</code></td><td>更新 lodash 包</td></tr></tbody></table>
+<table><thead><tr><th>命令</th><th>描述</th></tr></thead><tbody><tr><td><code>npm version &#x3C;version></code></td><td>要更改 <code>package.json</code> 中的版本号</td></tr><tr><td><code>npm update</code></td><td>更新生产包</td></tr><tr><td><code>npm update --dev</code></td><td>更新开发包</td></tr><tr><td><code>npm update -g</code></td><td>更新全局包</td></tr><tr><td><code>npm update lodash</code></td><td>更新 <code>lodash</code> 包</td></tr></tbody></table>
 </div></div></div><div class="wrap h3body-not-exist 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">
 <!--rehype:wrap-class=row-span-2-->
 <p>将某人添加为所有者</p>