mirror of
https://github.com/jaywcjlove/reference.git
synced 2025-06-17 20:51:21 +08:00
doc: update package.json.md. (#46) 7a22e7cda2
This commit is contained in:
jaywcjlove
@ -42,7 +42,7 @@
|
||||
<p>这个 <a href="https://www.npmjs.com/">npm</a> 快速参考备忘单显示了它的常用命令使用清单</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="#缓存-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="#更改包裹可见性">更改包裹可见性</a><a aria-hidden="true" class="leve3 tocs-link" href="#要将包转移到-npm-用户帐户">要将包转移到 npm 用户帐户</a><a aria-hidden="true" class="leve3 tocs-link" href="#发布包-npmjsorg">发布包 npmjs.org</a><a aria-hidden="true" class="leve3 tocs-link" href="#使用-nrm-切换-registry">使用 nrm 切换 registry</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="#registry">registry</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="#更改包裹可见性">更改包裹可见性</a><a aria-hidden="true" class="leve3 tocs-link" href="#要将包转移到-npm-用户帐户">要将包转移到 npm 用户帐户</a><a aria-hidden="true" class="leve3 tocs-link" href="#发布包-npmjsorg">发布包 npmjs.org</a><a aria-hidden="true" class="leve3 tocs-link" href="#使用-nrm-切换-registry">使用 nrm 切换 registry</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="#registry">registry</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="#纯-esm-包">纯 ESM 包</a><a aria-hidden="true" class="leve3 tocs-link" href="#commonjs-项目移动到-esm">CommonJS 项目移动到 ESM</a><a aria-hidden="true" class="leve3 tocs-link" href="#typescript-项目输出-esm">TypeScript 项目输出 ESM</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">
|
||||
|
||||
@ -398,6 +398,33 @@
|
||||
</span><span class="code-line"><span class="token comment">; 将适用于 @another</span>
|
||||
</span><span class="code-line"><span class="token key attr-name">//somewhere.com/another/:_authToken</span><span class="token punctuation">=</span><span class="token value attr-value">MYTOKEN2</span>
|
||||
</span></code></pre>
|
||||
</div></div></div></div></div><div class="wrap h2body-exist"><div class="wrap-header h2wrap"><h2 id="纯-esm-包"><a aria-hidden="true" tabindex="-1" href="#纯-esm-包"><span class="icon icon-link"></span></a>纯 ESM 包</h2><div class="wrap-body">
|
||||
</div></div><div class="h2wrap-body"><div class="wrap h3body-not-exist col-span-3"><div class="wrap-header h3wrap"><h3 id="commonjs-项目移动到-esm"><a aria-hidden="true" tabindex="-1" href="#commonjs-项目移动到-esm"><span class="icon icon-link"></span></a>CommonJS 项目移动到 ESM</h3><div class="wrap-body">
|
||||
<!--rehype:wrap-class=col-span-3-->
|
||||
<ul>
|
||||
<li>将 <code>"type": "module"</code> 添加到您的 <a href="./package.json.html">package.json</a></li>
|
||||
<li>将 <a href="./package.json.html">package.json</a> 中的 <code>"main": "index.js"</code> 替换为 <code>"exports": "./index.js"</code>。</li>
|
||||
<li>将 <a href="./package.json.html">package.json</a> 中的 <code>"engines"</code> 字段更新为 Node.js 14: <code>"node": ">=14.16"</code>。(不包括 <red><del>Node.js 12</del></red>，因为它不再受支持)</li>
|
||||
<li>删除 <code>"use strict"</code>；来自所有 JavaScript 文件</li>
|
||||
<li>将所有 <code>require()</code> / <code>module.export</code> 替换为 <code>import</code> / <code>export</code></li>
|
||||
<li>仅使用完整的相对文件路径进行导入：<code>import x from '.';</code> → <code>import x from './index.js';</code></li>
|
||||
<li>如果您有 <code>TypeScript</code> 类型定义（例如 <code>index.d.ts</code>），请将其更新为使用 ESM 导入/导出</li>
|
||||
<li>可选但推荐使用 <code>node:</code> 导入<a href="https://nodejs.org/api/esm.html#esm_node_imports">协议</a></li>
|
||||
</ul>
|
||||
</div></div></div><div class="wrap h3body-not-exist col-span-3"><div class="wrap-header h3wrap"><h3 id="typescript-项目输出-esm"><a aria-hidden="true" tabindex="-1" href="#typescript-项目输出-esm"><span class="icon icon-link"></span></a>TypeScript 项目输出 ESM</h3><div class="wrap-body">
|
||||
<!--rehype:wrap-class=col-span-3-->
|
||||
<ul>
|
||||
<li>确保您使用的是 TypeScript 4.7 或更高版本</li>
|
||||
<li>将 <code>"type": "module"</code> 添加到您的 <a href="./package.json.html">package.json</a></li>
|
||||
<li>将 <a href="./package.json.html">package.json</a> 中的 <code>"main": "index.js"</code> 替换为 <code>"exports": "./index.js"</code></li>
|
||||
<li>将 <a href="./package.json.html">package.json</a> 中的 <code>"engines"</code> 字段更新为 Node.js 14: <code>"node": ">=14.16"</code>。 （不包括 <red><del>Node.js 12</del></red>，因为它不再受支持）</li>
|
||||
<li>将 <code>"module": "node16"</code>, <code>"moduleResolution": "node16"</code> 添加到您的 <a href="./typescript.html">tsconfig.json</a> (<a href="https://github.com/sindresorhus/tsconfig/blob/main/tsconfig.json">列子</a>)</li>
|
||||
<li>仅使用完整的相对文件路径进行导入：<code>import x from '.';</code> → <code>import x from './index.js';</code></li>
|
||||
<li>删除 <code>namespace</code> 使用并改用 <code>export</code></li>
|
||||
<li>可选但推荐使用 <code>node:</code> 导入<a href="https://nodejs.org/api/esm.html#esm_node_imports">协议</a></li>
|
||||
<li><strong>即使您正在导入 <code>.ts</code> 文件，也必须在相对导入中使用 <code>.js</code> 扩展名</strong></li>
|
||||
</ul>
|
||||
<p>阅读<a href="https://www.typescriptlang.org/docs/handbook/esm-node.html">官方 ESM 指南</a></p>
|
||||
</div></div></div></div></div><div class="wrap h2body-not-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">
|
||||
<ul>
|
||||
<li><a href="https://docs.npmjs.com/">npm 仓库、网站和命令行界面的文档</a> <em>(npmjs.com)</em></li>
|
||||
|
||||
Reference in New Issue
Block a user