From 3929e6cba1f117f00e958d217ff4591061fc0294 Mon Sep 17 00:00:00 2001 From: jaywcjlove Date: Mon, 7 Nov 2022 09:37:19 +0000 Subject: [PATCH] doc: Update `npm.md`. a2d7cd6e7b7689fdc9cfb947c4cd9d3ee1c26e69 --- docs/npm.html | 112 ++++++++++++++++++++++++++++++++------------------ 1 file changed, 73 insertions(+), 39 deletions(-) diff --git a/docs/npm.html b/docs/npm.html index 997e426e..a0f9bf2a 100644 --- a/docs/npm.html +++ b/docs/npm.html @@ -5,7 +5,7 @@ npm 备忘清单 & npm cheatsheet & Quick Reference - + @@ -39,10 +39,10 @@ npm 备忘清单
-

这个 npm 快速参考备忘单显示了它的常用命令使用清单。

+

这个 npm 快速参考备忘单显示了它的常用命令使用清单

常用命令

+

常用命令

包管理

@@ -203,7 +203,7 @@ npm cache verify # 验证缓存文件夹的内容，垃圾收集任何不需要的数据， # 并验证缓存索引和所有缓存数据的完整性 -

用于添加、列出或清理 npm 缓存文件夹

+

用于添加、列出或清理 npm 缓存文件夹

更新

@@ -234,33 +234,33 @@ -
命令描述
npm version <version>要更改 package.json 中的版本号
npm update更新生产包
npm update --dev更新开发包
npm update -g更新全局包
npm update lodash更新 lodash 包
+
命令描述
npm version <version>要更改 package.json 中的版本号
npm update更新生产包
npm update --dev更新开发包
npm update -g更新全局包
npm update lodash更新 lodash 包

杂项功能

-

将某人添加为所有者

-
npm owner add USERNAME PACKAGENAME
+
# 将某人添加为所有者
+npm owner add USERNAME PACKAGENAME
+# 列出包
+npm ls
+# 向安装旧版本软件包的用户添加警告(弃用)
+npm deprecate PACKAGE@"< 0.2.0" "critical bug fixed in v0.2.0"
+# 更新所有包或选定的包
+npm update [-g] PACKAGE
+# 检查过时的包
+npm outdated [PACKAGE]
 

-
列出包

-
npm ls
-

-
向安装旧版本软件包的用户添加警告(弃用)

-
npm deprecate PACKAGE@"< 0.2.0" "critical bug fixed in v0.2.0"
-

-
更新所有包或选定的包

-
npm update [-g] PACKAGE
-

-
检查过时的包

-
npm outdated [PACKAGE]
+

取消发布包

+
npm unpublish <package-name> -f
+# 取消指定版本
+npm unpublish <package-name>@<version>
+

注意：如果您取消发布整个包，则必须在 24 小时后才能发布该包的任何新版本

更改包裹可见性

-

将公共包设为私有

-
npm access restricted <package-name>
-
-

公开私有包

-
npm access public <package-name>
-
-

授予私有包访问权限

-
npm owner add <user> <your-package-name>
+
# 将公共包设为私有
+$ npm access restricted <package-name>
+# 公开私有包
+$ npm access public <package-name>
+# 授予私有包访问权限
+$ npm owner add <user> <your-package-name>

要将包转移到 npm 用户帐户

npm owner add <their-username> <package-name>
@@ -270,18 +270,17 @@
 
写入启用了双因素身份验证

 
npm owner add <their-username> <package-name> --otp=123456
 

-

取消发布包

-
npm unpublish <package-name> -f
-# 取消指定版本
-npm unpublish <package-name>@<version>
-
-

注意：如果您取消发布整个包，则必须在 24 小时后才能发布该包的任何新版本。

发布包 npmjs.org

npm publish
 # 第一次需要指定公开参数
 npm publish --access public
-

发布公开包，到 npmjs.org

+

发布公开包，到 npmjs.org

+

使用 nrm 切换 registry

+
$ npm install -g nrm # 安装 nrm 包
+$ nrm ls             # 查看 registry 列表
+$ nrm use cnpm       # 将注册表切换到 cnpm
+

配置

.npmrc

@@ -310,13 +309,48 @@
:-:-
/path/to/project/.npmrc每个项目的配置文件
~/.npmrc每个用户的配置文件
$PREFIX/etc/npmrc全局配置文件
/path/to/npm/npmrcnpm 内置配置文件
-

配置内容

- -
# last modified: 01 Jan 2016
+

配置内容

+
# last modified: 01 Jan 2016
 ; Set a new registry for a scoped package
 @myscope:registry=https://registry.npmmirror.com
-

注释使用 #, ; 放置到一行的开头。.npmrc 文件由指定此注释语法的 npm/ini 解析

+ +

注释使用 #, ; 放置到一行的开头， .npmrc 文件由指定此注释语法的 npm/ini 解析

+

registry

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
:-:-
npmhttps://registry.npmjs.org/
yarnhttps://registry.yarnpkg.com/
tencenthttps://mirrors.cloud.tencent.com/npm/
cnpmhttps://r.cnpmjs.org/
taobaohttps://registry.npmmirror.com/
npmMirrorhttps://skimdb.npmjs.com/registry/

.npmignore

将下面内容存放到 .npmignore 文件中，放置在项目的根目录中。

.git
@@ -334,7 +368,7 @@
 
# 临时使用
 $ npm install -g <package-name> --registry=https://registry.npmmirror.com
 

-
将配置放置在 .npmrc 全局配置文件中，或者在项目的根目录中。

+
将配置放置在 .npmrc 全局配置文件中，或者在项目的根目录中。

 
; registry=https://registry.npmjs.org/
 registry=https://registry.npmmirror.com
 

@@ -344,7 +378,7 @@
 }

替换 npm 仓库地址为 npmmirror(淘宝) 镜像地址

-
npm config set registry https://registry.npmmirror.com
+
$ npm config set registry https://registry.npmmirror.com
 

 
请参阅：npmmirror 中国镜像站

 
electronjs 镜像和缓存