npm
在前端开发流程中提供了非常完善的自动化工具链,已成为每个前端开发者必备的工具,但是同样由于其强大性导致很多前端开发者只会简单的使用它。本文将总结在日常开发中所需要的npm
知识点,以便开发者们更好的将npm
运用在实际开发中。
一个项目开发、上线所依赖的插件包都存放在node_modules
中。虽然在实际开发中无需关注这个目录里面的文件结构细节,但了解node_modules
中的内容可以帮助我们更好的理解npm
组织这些文件的机制。
假设项目App
中有如下三个依赖:
"dependencies": { A: "1.0.0", B: "1.0.0", C: "1.0.0"}
A: "1.0.0",
B: "1.0.0",
C: "1.0.0"
}
A
、B
、C
三个模块又有如下依赖:
[email protected] -> [email protected]@1.0.0 -> [email protected]@1.0.0 -> [email protected]0 -> D@1.0.0
B@1.0.0 -> D@2.0.0
C@1.0.0 -> D@1.0.0
npm 2.x
安装依赖方式比较简单直接,以递归的方式,按照包依赖的树形结构下载填充本地目录结构,也就是说每个包都会将该包的依赖安装到当前包所在的node_modules
目录中。
执行npm install
后,项目App
的node_modules
会变成如下目录结构:
├── node_modules│ ├── [email protected]│ │ └── node_modules│ │ │ └── [email protected]│ ├── [email protected]│ │ └── node_modules│ │ │ └── [email protected]│ └── [email protected]│ │ └── node_modules│ │ │ └── [email protected]0.0
│ │ └── node_modules
│ │ │ └── D@1.0.0
│ ├── B@1.0.0
│ │ └── node_modules
│ │ │ └── D@2.0.0
│ └── C@1.0.0
│ │ └── node_modules
│ │ │ └── D@1.0.0
很显然这样的依赖组织结构,有如下优点:
但是缺点也一样很明显:
npm 3.x
则采用了扁平化的结构来安装组织node_modules
。也就是在执行npm install
的时候,按照package.json
里依赖的顺序依次解析,遇到新的包就把它安装在第一级目录,后续安装如果遇到一级目录已经存在的包,会先按照约定版本判断版本,如果符合版本约定则忽略,否则会按照npm 2.x
的方式依次挂在依赖包目录下。
还以项目App
为例,在npm 3.x
环境下,执行npm install
后,node_modules
会变成如下目录结构:
├── node_modules│ ├── [email protected]│ ├── [email protected]│ ├── [email protected]│ │ └── node_modules│ │ │ └── [email protected]│ └── [email protected]0.0
│ ├── D@1.0.0
│ ├── B@1.0.0
│ │ └── node_modules
│ │ │ └── D@2.0.0
│ └── C@1.0.0
模块的安装次序决定了
node_modules
中的目录结构,npm
会优先将模块安装在根目录下的node_modules
中。
再在项目中安装模块[email protected]
(依赖于模块[email protected]
),目录结构变为:
├── node_modules│ ├── [email protected]│ ├── [email protected]│ ├── [email protected]│ │ └── node_modules│ │ │ └── [email protected]│ └── [email protected]│ ├── [email protected]│ │ └── node_modules│ │ │ └── [email protected]0.0
│ ├── D@1.0.0
│ ├── B@1.0.0
│ │ └── node_modules
│ │ │ └── D@2.0.0
│ └── C@1.0.0
│ ├── E@1.0.0
│ │ └── node_modules
│ │ │ └── D@2.0.0
B
、E
模块下都包含了依赖的模块[email protected]
,存在代码冗余的情况。
再在项目中安装模块[email protected]
(依赖于模块[email protected]
)。由于[email protected]
已经存在于项目根目录下的node_modules
下,所以在安装F
模块的时候,无需再在其依赖包中安装[email protected]
模块,目录结构变为:
├── node_modules│ ├── [email protected]│ ├── [email protected]│ ├── [email protected]│ │ └── node_modules│ │ │ └── [email protected]│ └── [email protected]│ ├── [email protected]│ │ └── node_modules│ │ │ └── [email protected]│ └── [email protected]0.0
│ ├── D@1.0.0
│ ├── B@1.0.0
│ │ └── node_modules
│ │ │ └── D@2.0.0
│ └── C@1.0.0
│ ├── E@1.0.0
│ │ └── node_modules
│ │ │ └── D@2.0.0
│ └── F@1.0.0
从以上结构可以看出,npm 3.x
并没有完美的解决npm 2.x
中的问题,甚至还会退化到npm 2.x
的行为。
为了解决目录中存在很多副本的情况,(在A
、C
模块的依赖模块D
升级到2.0.0
前提下)可以通过npm dedupe
指令把所有二级的依赖模块[email protected]
重定向到一级目录下:
├── node_modules│ ├── [email protected]│ ├── [email protected]│ ├── [email protected]│ └── [email protected]│ ├── [email protected]│ └── [email protected]0.0
│ ├── D@2.0.0
│ ├── B@1.0.0
│ └── C@1.0.0
│ ├── E@1.0.0
│ └── F@1.0.0
node_modules路径查找机制:模块再找对应的依赖包时,
nodejs
会尝试从当前模块所在目录开始,尝试在它的node_modules
文件夹里加载相应模块,如果没有找到,那么就再向上一级目录移动,直到全局安装路径中的node_modules
为止。
从npm 5.x
开始,安装组织node_modules
和npm 3.x
一样采用了扁平化的方式,最大的变化是增加了 package-lock.json 文件。
npm
为了让开发者在安全的前提下使用最新的依赖包,在package.json
中通常做了锁定大版本的操作,这样在每次npm install
的时候都会拉取依赖包大版本下的最新的版本。这种机制最大的一个缺点就是当有依赖包有小版本更新时,可能会出现协同开发者的依赖包不一致的问题。
package-lock.json
文件精确描述了node_modules
目录下所有的包的树状依赖结构,每个包的版本号都是完全精确的。以sass-loader
在package-lock.json
中为例:
"dependencies": { "sass-loader": { "version": "7.1.0", "resolved": "http://registry.npm.taobao.org/sass-loader/download/sass-loader-7.1.0.tgz", "integrity": "sha1-Fv1ROMuLQkv4p1lSihly1yqtBp0=", "dev": true, "requires": { "clone-deep": "^2.0.1", "loader-utils": "^1.0.1", "lodash.tail": "^4.1.1", "neo-async": "^2.5.0", "pify": "^3.0.0", "semver": "^5.5.0" }, "dependencies": { "pify": { "version": "3.0.0", "resolved": "http://registry.npm.taobao.org/pify/download/pify-3.0.0.tgz", "integrity": "sha1-5aSs0sEB/fPZpNB/DbxNtJ3SgXY=", "dev": true } } }}
"sass-loader": {
"version": "7.1.0",
"resolved": "http://registry.npm.taobao.org/sass-loader/download/sass-loader-7.1.0.tgz",
"integrity": "sha1-Fv1ROMuLQkv4p1lSihly1yqtBp0=",
"dev": true,
"requires": {
"clone-deep": "^2.0.1",
"loader-utils": "^1.0.1",
"lodash.tail": "^4.1.1",
"neo-async": "^2.5.0",
"pify": "^3.0.0",
"semver": "^5.5.0"
},
"dependencies": {
"pify": {
"version": "3.0.0",
"resolved": "http://registry.npm.taobao.org/pify/download/pify-3.0.0.tgz",
"integrity": "sha1-5aSs0sEB/fPZpNB/DbxNtJ3SgXY=",
"dev": true
}
}
}
}
package-lock.json
的详细描述主要由version
、resolved
、integrity
、dev
、requires
、dependencies
这几个字段构成:
在上面的package-lock.json
文件中可以发现,在requires
和dependencies
中都存在pify
依赖项。那我们顺便去node_modules
里面探下究竟:
打开根目录的node_modules
会发现安装了sass-loader
所需要的所有依赖包,这些依赖包中除了pify
以外,所有依赖包的大版本号都与sass-loader
所需要的一致。
到根目录的node_modules
找到pify
依赖包,发现版本为4.0.1
。
找到sass-loader
项目依赖包,打开其node_modules
发现其中也存在个pify
依赖包,但版本为3.0.0
。这个版本的sass-loader
真正依赖的是这个版本的pify
。
通过以上几个步骤,也验证了之前阐述过的npm 5.x
是扁平化处理依赖的方式。
在开发一个应用时,建议把package-lock.json
文件提交到代码版本仓库,从而让你的团队成员、运维部署人员或CI
系统可以在执行npm install
时安装的依赖版本都是一致的。
但是在开发一个库时,则不应把package-lock.json
文件发布到仓库中。实际上,npm
也默认不会把package-lock.json
文件发布出去。之所以这么做,是因为库项目一般是被其他项目依赖的,在不写死的情况下,就可以复用主项目已经加载过的包,而一旦库依赖的是精确的版本号那么可能会造成包的冗余。
在 node
中其实总共有5种依赖:
作为npm
的使用者,我们常用的依赖是dependencies
和devDependencies
,剩下三种依赖则是作为包的发布者才会使用到的字段。
这种依赖在项目最终上线或者发布npm
包时所需要,即其中的依赖项应该属于线上代码的一部分。比如框架vue
,第三方的组件库element-ui
等,这些依赖包都是必须装在这个选项里供生产环境使用。
通过命令npm install/i packageName -S/--save
把包装在此依赖项里。如果没有指定版本,直接写一个包的名字,则安装当前npm仓库中这个包的最新版本。如果要指定版本的,可以把版本号写在包名后面,比如npm i [email protected] -S
。
从
npm 5.x
开始,可以不用手动添加-S/--save
指令,直接执行npm i packageName
把依赖包添加到dependencies
中去。
这种依赖只在项目开发时所需要,即其中的依赖项不应该属于线上代码的一部分。比如构建工具webpack
、gulp
,预处理器babel-loader
、scss-loader
,测试工具e2e
、chai
等,这些都是辅助开发的工具包,无须在生产环境使用。
通过命令npm install/i -D/--save-dev
把包安装成开发依赖。如果想缩减安装包,可以使用命令npm i --production
忽略开发依赖,只安装基本依赖,这通常在线上机器(或者QA
环境)上使用。
千万别以为只有在
dependencies
中的模块才会被一起打包,而在devDependencies
中的不会!模块能否被打包,取决于项目里是否被引入了该模块!
在业务项目中dependencies
和devDependencies
没有什么本质区别,只是单纯的一个规范作用,在执行npm i
时两个依赖下的模块都会被下载;而在发布npm
包的时候,包中的dependencies
依赖项在安装该包的时候会被一起下载,devDependencies
依赖项则不会。
这种依赖的作用是提示宿主环境去安装插件在peerDependencies
中所指定依赖的包,然后插件所依赖的包永远都是宿主环境统一安装的npm
包,最终解决插件与所依赖包不一致的问题。
这句话听起来可能有点拗口,举个例子来给大家说明下。[email protected]
只是提供一套基于vue
的ui
组件库,但它要求宿主环境需要安装指定的vue
版本,所以你可以看到element
项目中的package.json
中具有一项配置:
"peerDependencies": { "vue": "^2.5.16"}
"vue": "^2.5.16"
}
它要求宿主环境安装3.0.0 > vue@ >= 2.5.16
的版本,也就是element-ui
的运行依赖宿主环境提供的该版本范围的vue
依赖包。
在安装插件的时候,peerDependencies
在npm 2.x
和npm 3.x
中表现不一样:
在npm 2.x
中,安装包中peerDependencies
所指定的依赖会随着npm install packageName
一起被强制安装,并且peerDependencies
中指定的依赖会安装在宿主环境中,所以不需要在宿主环境的package.json
文件中指定对所安装包中peerDependencies
内容的依赖。
在npm 3.x
中,不会再要求peerDependencies
所指定的依赖包被强制安装,npm 3.x
只会在安装结束后检查本次安装是否正确,如果不正确会给用户打印警告提示,比如提示用户有的包必须安装或者有的包版本不对等。
大白话:如果你安装我,那么你最好也要按照我的要求安装A、B和C。
这种依赖跟npm pack
打包命令有关。假设package.json
中有如下配置:
{ "name": "font-end", "version": "1.0.0", "dependencies": { "fe1": "^0.3.2", ... }, "devDependencies": { ... "fe2": "^1.0.0" }, "bundledDependencies": [ "fe1", "fe2" ]}"name": "font-end",
"version": "1.0.0",
"dependencies": {
"fe1": "^0.3.2",
...
},
"devDependencies": {
...
"fe2": "^1.0.0"
},
"bundledDependencies": [
"fe1",
"fe2"
]
}
执行打包命令npm pack
,会生成front-end-1.0.0.tgz
压缩包,并且该压缩包中包含fe1
和fe2
两个安装包,这样使用者执行npm install front-end-1.0.0.tgz
也会安装这两个依赖。
在
bundledDependencies
中指定的依赖包,必须先在dependencies
和devDependencies
声明过,否则打包会报错。
这种依赖中的依赖项即使安装失败了,也不影响整个安装的过程。需要注意的是,如果一个依赖同时出现在dependencies
和optionalDependencies
中,那么optionalDependencies
会获得更高的优先级,可能造成一些预期之外的效果,所以尽量要避免这种情况发生。
在实际项目中,如果某个包已经失效,我们通常会寻找它的替代者,或者换一个实现方案。不确定的依赖会增加代码判断和测试难度,所以这个依赖项还是尽量不要使用。
npm
采用了semver
规范作为依赖版本管理方案。
按照semver
的约定,一个npm
依赖包的版本格式一般为:主版本号.次版本号.修订号(x.y.z
),每个号的含义是:
如果大版本号是 0 的话,表示软件处于开发初始阶段,一切都可能随时被改变,可能每个小版本之间也会存在不兼容性。所以在选择依赖时,尽量避开大版本号是 0 的包。
常见的几个版本格式如下:
npm 2.x/3.x
已成为过去式,在npm 5.x
以上环境下(版本最好在5.6
以上,因为在5.0 ~ 5.6
中间对package-lock.json
的处理逻辑更新过几个版本,5.6
以上才开始稳定),管理项目中的依赖包版本你应该知道(以^
版本为例,其他类型版本参照即可):
在大版本相同的前提下,如果一个模块在package.json
中的小版本要大于package-lock.json
中的小版本,则在执行npm install
时,会将该模块更新到大版本下的最新的版本,并将版本号更新至package-lock.json
。如果小于,则被package-lock.json
中的版本锁定。
// package-lock.json 中原版本"clipboard": { "version": "1.5.10", },"vue": { "version": "2.6.10",}// package.json 中修改版本"dependencies": { "clipboard": "^1.5.12", "vue": "^2.5.6" ...}// 执行完 npm install 后,package-lock.json 中"clipboard": { "version": "1.7.1", // 更新到大版本下的最新版本},"vue": { "version": "2.6.10", // 版本没发生改变}
"clipboard": {
"version": "1.5.10",
},
"vue": {
"version": "2.6.10",
}
// package.json 中修改版本
"dependencies": {
"clipboard": "^1.5.12",
"vue": "^2.5.6"
...
}
// 执行完 npm install 后,package-lock.json 中
"clipboard": {
"version": "1.7.1", // 更新到大版本下的最新版本
},
"vue": {
"version": "2.6.10", // 版本没发生改变
}
如果一个模块在package.json
和package-lock.json
中的大版本不相同,则在执行npm install
时,都将根据package.json
中大版本下的最新版本进行更新,并将版本号更新至package-lock.json
。
// package-lock.json 中原版"clipboard": { "version": "2.0.4",}// package.json 中修改版本"dependencies": { "clipboard": "^1.6.1",}// 执行完npm install后,package-lock.json 中// "clipboard": { "version": "1.7.1", // 更新到大版本下的最新版本}
"clipboard": {
"version": "2.0.4",
}
// package.json 中修改版本
"dependencies": {
"clipboard": "^1.6.1",
}
// 执行完npm install后,package-lock.json 中
//
"clipboard": {
"version": "1.7.1", // 更新到大版本下的最新版本
}
如果一个模块在package.json
中有记录,而在package-lock.json
中无记录,执行npm install
后,则会在package-lock.json
生成该模块的详细记录。同理,一个模块在package.json
中无记录,而在package-lock.json
中有记录,执行npm install
后,则会在package-lock.json
删除该模块的详细记录。
如果要更新某个模块大版本下的最新版本(升级小版本号),请执行如下命令:
npm install packageName// 或者npm update packageName
npm update packageName
如果要更新到指定版本号(升级大版本号),请执行如下命令:
npm install [email protected]
卸载某个模块,请执行如下命令:
npm uninstall packageName
通过上述的命令来管理依赖包,package.json
和package-lock.json
中的版本号都将会随之更新。
我们在升级/卸载依赖包的时候,尽量通过命令来实现,避免手动修改
package.json
中的版本号,尤其不要手动修改package-lock.json
。
package.json
中的 scripts 字段可以用来自定义脚本命令,它的每一个属性,对应一段脚本。以vue-cli3
为例:
"scripts": { "serve": "vue-cli-service serve", ...}
"serve": "vue-cli-service serve",
...
}
这样就可以通过npm run serve
脚本代替vue-cli-service serve
脚本来启动项目,而无需每次敲一遍这么冗长的脚本。
package.json
中的字段 bin 表示的是一个可执行文件到指定文件源的映射。例如在@vue/cli-service
的package.json
中:
"bin": { "vue-cli-service": "bin/vue-cli-service.js"}
"vue-cli-service": "bin/vue-cli-service.js"
}
如果全局安装@vue/cli-service
的话,@vue/cli-service
源文件会被安装在全局源文件安装目录(/user/local/lib/node_modules
)下,而npm
会在全局可执行bin
文件安装目录(/usr/local/bin
)下创建一个指向../lib/node_modules/@vue/cli-service/bin/vue-cli-service.js
文件的名为vue-cli-service
的软链接,这样就可以直接在终端输入vue-cli-service
来执行。
如果局部安装@vue/cli-service
的话,npm
则会在本地项目node_modules/.bin
目录下创建一个指向../@vue/cli-service/bin/vue-cli-service.js
名为vue-cli-service
的软链接,这个时候需要在终端中输入./node_modules/.bin/vue-cli-service
来执行(也可以使用npx vue-cli-service
命令来执行,npx 的作用就是为了方便调用项目内部安装的模块)。
软链接(符号链接)是一类特殊的可执行文件, 其包含有一条以绝对路径或者相对路径的形式指向其它文件或者目录的引用。在
bin
目录下执行ll
指令可以查看具体的软链接指向。在对链接文件进行读或写操作的时候,系统会自动把该操作转换为对源文件的操作,但删除链接文件时,系统仅仅删除链接文件,而不删除源文件本身。
在terminal
中执行命令时,命令会在PATH
环境变量里包含的路径中去寻找相同名字的可执行文件。局部安装的包只在./node_modules/.bin
中注册了它们的可执行文件,不会被包含在PATH
环境变量中,这个时候在terminal
中输入命令将会报无法找到的错误。
那为什么通过npm run
可以执行局部安装的命令行包呢?
是因为每当执行npm run
时,会自动新建一个Shell
,这个 Shell
会将当前项目的node_modules/.bin
的绝对路径加入到环境变量PATH
中,执行结束后,再将环境变量PATH
恢复原样。
我们来验证下这个说法。首先执行 env 查看当前所有的环境变量,可以看到PATH
环境变量为:
PATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
再在当前项目下执行npm run env
查看脚本运行时的环境变量,可以看到PATH
环境变量为:
PATH=/usr/local/lib/node_modules/npm/node_modules/npm-lifecycle/node-gyp-bin:/Users/mac/Vue-projects/hao-cli/node_modules/.bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbinlocal/bin:/usr/bin:/bin:/usr/sbin:/sbin
可以看到运行时的PATH
环境变量多了两个路径:npm
指令路径和项目中node_modules/.bin
的绝对路径。
所以,通过npm run
可以在不添加路径前缀的情况下直接访问当前项目node_modules/.bin
目录里面的可执行文件。
PATH
环境变量,是告诉系统,当要求系统运行一个程序而没有告诉它程序所在的完整路径时,系统除了在当前目录下面寻找此程序外,还应到哪些目录下去寻找。
关于scripts
中的参数,这里要多说几句。网上有很多不是很准确的说法,经过本人的反复试验,node
处理scripts
参数其实很简单,比如:
"scripts": { "serve": "vue-cli-service serve", "serve1": "vue-cli-service --serve1", "serve2": "vue-cli-service -serve2", "serve3": "vue-cli-service serve --mode=dev --mobile -config build/example.js"}
"serve": "vue-cli-service serve",
"serve1": "vue-cli-service --serve1",
"serve2": "vue-cli-service -serve2",
"serve3": "vue-cli-service serve --mode=dev --mobile -config build/example.js"
}
除了第一个可执行的命令,以空格分割的任何字符串(除了一些shell的语法)都是参数,并且都能通过process.argv
属性访问。
process.argv
属性返回一个数组,这个数组包含了启动node
进程时的命令行参数。第一个元素为启动node
进程的可执行文件的绝对路径名process.execPath,第二个元素为当前执行的JavaScript文件路径。剩余的元素为其他命令行参数。
比如执行npm run serve3
命令,process.argv
的具体内容为:
[ '/usr/local/Cellar/node/7.7.1_1/bin/node', '/Users/mac/Vue-projects/hao-cli/node_modules/.bin/vue-cli-service', 'serve', '--mode=dev', '--mobile', '-config', 'build/example.js']
'/Users/mac/Vue-projects/hao-cli/node_modules/.bin/vue-cli-service',
'serve',
'--mode=dev',
'--mobile',
'-config',
'build/example.js']
很多命令行包之所以这么写,都是依赖了 minimist 或者 yargs 等参数解析工具来对命令行参数进行解析。
以minimist
对vue-cli-service serve --mode=dev --mobile -config build/example.js
解析为例,解析后的结果为:
{ _: [ 'serve' ], mode: 'dev', mobile: true, config: 'build/example.js', '$0': '/Users/mac/Vue-projects/hao-cli/node_modules/.bin/vue-cli-service'}'serve' ],
mode: 'dev',
mobile: true,
config: 'build/example.js',
'$0': '/Users/mac/Vue-projects/hao-cli/node_modules/.bin/vue-cli-service'}
在./node_modules/.bin/vue-cli-service
文件中可以看到minimist
对命令行参数的处理:
const rawArgv = process.argv.slice(2)const args = require('minimist')(rawArgv, { boolean: [ // build 'modern', 'report', 'report-json', 'watch', // serve 'open', 'copy', 'https', // inspect 'verbose' ]})const command = args._[0]service.run(command, args, rawArgv).catch(err => { error(err) process.exit(1)})2)
const args = require('minimist')(rawArgv, {
boolean: [
// build
'modern',
'report',
'report-json',
'watch',
// serve
'open',
'copy',
'https',
// inspect
'verbose'
]
})
const command = args._[0]
service.run(command, args, rawArgv).catch(err => {
error(err)
process.exit(1)
})
我们还可以通过命令行传参的形式来进行参数传递:
npm run serve --params // 参数params将转化成process.env.npm_config_params = truenpm run serve --params=123 // 参数params将转化成process.env.npm_config_params = 123npm run serve -params // 等同于--params参数npm run serve -- --params // 将--params参数添加到process.env.argv数组中npm run serve params // 将params参数添加到process.env.argv数组中npm run serve -- params // 将params参数添加到process.env.argv数组中
npm run serve --params=123 // 参数params将转化成process.env.npm_config_params = 123
npm run serve -params // 等同于--params参数
npm run serve -- --params // 将--params参数添加到process.env.argv数组中
npm run serve params // 将params参数添加到process.env.argv数组中
npm run serve -- params // 将params参数添加到process.env.argv数组中
有的项目在启动时可能需要同时执行多个任务,多个任务的执行顺序决定了项目的表现。
串行执行,要求前一个任务执行成功以后才能执行下一个任务,使用&&
符号来连接。
npm run script1 && npm run script2
串行命令执行过程中,只要一个命令执行失败,则整个脚本终止。
并行执行,就是多个命令可以同时的平行执行,使用&
符号来连接。
npm run script1 & npm run script2
这两个符号是Bash
的内置功能。此外,还可以使用第三方的任务管理器模块:script-runner、npm-run-all、redrun。
在执行npm run
脚本时,npm
会设置一些特殊的env
环境变量。其中package.json
中的所有字段,都会被设置为以npm_package_
开头的环境变量。比如package.json
中有如下字段内容:
{ "name": "sh", "version": "1.1.1", "description": "shenhao", "main": "index.js", "repository": { "type": "git", "url": "git+ssh://[email protected]/xxxx/sh.git" }}"name": "sh",
"version": "1.1.1",
"description": "shenhao",
"main": "index.js",
"repository": {
"type": "git",
"url": "git+ssh://[email protected]/xxxx/sh.git"
}
}
可以通过process.env.npm_package_name
可以获取到package.json
中name
字段的值sh
,也可以通过process.env.npm_package_repository_type
获取到嵌套属性type
的值git
。
同时,npm
相关的所有配置也会被设置为以npm_config_
开头的环境变量。
此外,还会设置一个比较特殊的环境变量npm_lifecycle_event
,表示正在运行的脚本名称。比如执行npm run serve
的时候,process.env.npm_lifecycle_event
值为serve
,通过判断这个变量,可以将一个脚本使用在不同的npm scripts
中。
这些环境变量只能在
npm run
的脚本执行环境内拿到,正常执行的node
脚本是获取不到的。所以,不能直接通过env $NODE_ENV
的形式访问,但可以在scripts
中定义脚本"scripts": "echo $NODE_ENV"
来访问。
在执行npm scripts
命令(无论是自定义还是内置)时,都经历了pre
和post
两个钩子,在这两个钩子中可以定义某个命令执行前后的命令。
比如在执行npm run serve
命令时,会依次执行npm run preserve
、npm run serve
、npm run postserve
,所以可以在这两个钩子中自定义一些动作:
"scripts": { "preserve": "xxxxx", "serve": "vue-cli-service serve", "postserve": "xxxxxx"}
"preserve": "xxxxx",
"serve": "vue-cli-service serve",
"postserve": "xxxxxx"
}
当然,如果没有指定preserve
、postserve
,会默默的跳过。如果想要指定钩子,必须严格按照pre
和post
前缀来添加。
上面提到过一个环境变量process.env.npm_lifecycle_event
可以配合钩子来一起使用:
const event = process.env.npm_lifecycle_eventif (event === 'preserve') { console.log('Running the preserve task!')} else if (_event === 'serve') { console.log('Running the serve task!')}
if (event === 'preserve') {
console.log('Running the preserve task!')
} else if (_event === 'serve') {
console.log('Running the serve task!')
}
npm
的配置操作可以帮助我们预先设定好npm
对项目的行为动作,也可以让我们预先定义好一些配置项以供项目中使用。所以了解npm
的配置机制也是很有必要。
npm
可以从不同的来源获取其配置值,按优先级从高到低的顺序排序:
npm run serve --params=123
执行上述命令时,会将配置项params
的值设为123
,通过process.env.npm_config_params
可以访问其配置值。这个时候的params
配置值将覆盖所有其他来源存在的params
配置值。
如果env
环境变量中存在以npm_config_
为前缀的环境变量,则会被识别为npm
的配置属性。比如在env
环境变量中设置npm_config_package_lock
变量:
export npm_config_package_lock=false // 修改的是内存中的变量,只对当前终端有效false // 修改的是内存中的变量,只对当前终端有效
这时候执行npm install
,npm
会从环境变量中读取到这个配置项,从而不会生成package-lock.json
文件。
查看某个环境变量:
echo $NODE_ENV
删除某个环境变量:unset NODE_ENV
通过修改 npmrc 文件可以直接修改配置。系统中存在多个npmrc
文件,这些npmrc
文件被访问的优先级从高到低的顺序为:
.npmrc参照 npm/ini 格式编写。
通过npm config ls -l
查看npm
内部的默认配置参数。如果命令行、环境变量、所有配置文件都没有配置参数,则使用默认参数值。
npm
提供了几个 npm config 指令来进行用户级和全局级配置:
npm config set [-g|--global]npm config set registry # 指定下载 npm 包的来源,默认为 https://registry.npmjs.org/ ,可以指定私有源
npm config set registry # 指定下载 npm 包的来源,默认为 https://registry.npmjs.org/ ,可以指定私有源
使用-g|--global
标志修改或新增全局级配置,不使用的话修改或者新增用户级配置(相应级别的.npmrc
文件会更新)。
如果key
不存在,则会新增到配置中。如果省略value
,则key
会被设置成true
。
还可以覆盖package.json
中config
字段的值:
// package.json{ "name" : "foo", "config" : { "port" : "8080" }, "scripts" : { "start" : "node server.js" }}
"name" : "foo",
"config" : { "port" : "8080" },
"scripts" : { "start" : "node server.js" }
}
// server.jsconsole.log(process.env.npm_package_config_port)
console.log(process.env.npm_package_config_port)
npm config set foo:port 8000 # 打印8000# 打印8000
npm config get npm config get prefix # 获取npm的安装路径# 获取npm的安装路径
按照配置优先级,获取指定配置项的值。
npm config delete
npm
官网上说可以删除所有配置文件中指定的配置项,但经实验无法删除项目级的.npmrc
文件里指定的配置项。
npm config list [-l] [--json]
加上-l
或者--json
查看所有的配置项,包括默认的配置项。不加的话,不能查看默认的配置项。
npm config edit [-g|--global]
在编辑器中打开配置文件。使用-g|--global
标志编辑全局级配置和默认配置,不使用的话编辑用户级配置和默认配置。
参考 npm config 来获取更多的默认配置。
package.json
中的version
字段代表的是该项目的版本号。每当项目发布新版本时,需要将version
字段进行相应的更新以便后期维护。虽然可以手动的修改vsersion
字段,但是为了整个发布过程的自动化,尽量使用 npm version 指令来自动更新version
:
npm version (v)1.2.3 # 显示设置版本号为 1.2.3 npm version major # 大版本号加 1,其余版本号归 0npm version minor # 小版本号加 1,修订号归 0npm version patch # 修订号加 1
npm version major # 大版本号加 1,其余版本号归 0
npm version minor # 小版本号加 1,修订号归 0
npm version patch # 修订号加 1
显示的设置版本号时,版本号必须符合
semver
规范,允许在版本号前加上个v
标识。
如果不想让此次更新正式发布,还可以创建预发布版本:
# 当前版本号为 1.2.3npm version prepatch # 版本号变为 1.2.4-0,也就是 1.2.4 版本的第一个预发布版本npm version preminor # 版本号变为 1.3.0-0,也就是 1.3.0 版本的第一个预发布版本npm version premajor # 版本号变为 2.0.0-0,也就是 2.0.0 版本的第一个预发布版本npm version prerelease # 版本号变为 2.0.0-1,也就是使预发布版本号加一
npm version prepatch # 版本号变为 1.2.4-0,也就是 1.2.4 版本的第一个预发布版本
npm version preminor # 版本号变为 1.3.0-0,也就是 1.3.0 版本的第一个预发布版本
npm version premajor # 版本号变为 2.0.0-0,也就是 2.0.0 版本的第一个预发布版本
npm version prerelease # 版本号变为 2.0.0-1,也就是使预发布版本号加一
在git
环境中,执行npm version
修改完版本号以后,还会默认执行git add
->git commit
->git tag
操作:
其中commit message
默认是自动修改完的版本号,可以通过添加-m/--message
选项来自定义commit message
:
npm version xxx -m "upgrade to %s for reasons" # %s 会自动替换为新版本号# %s 会自动替换为新版本号
比如执行npm version minor -m "feat(version): upgrade to %s for reasons"
后:
如果git
工作区还有未提交的修改,npm version
将会执行失败,可以加上-f/--force
后缀来强制执行。
如果不想让npm version
指令影响你的git
仓库,可以在指令中使用--no-git-tag-version
参数:
npm --no-git-tag-version version xxx
如果想默认不影响你的git
仓库,可以在npm
设置中禁止:
npm config set git-tag-version false # 不自动打 tagnpm config set commit-hooks false # 不自动 commitversion false # 不自动打 tag
npm config set commit-hooks false # 不自动 commit
不经常发布包的同学可能对模块 tag 概念不是很清楚。以vue
为例,首先执行npm dist-tag ls vue
查看vue
包的tag
:
beta: 2.6.0-beta.3csp: 1.0.28-csplatest: 2.6.10.6.0-beta.3
csp: 1.0.28-csp
latest: 2.6.10
上面列出的beta
、csp
、latest
就是tag
。每个tag
对应了一个版本。
那tag
到底有什么用呢?tag
类似于git
里面分支的概念,发布者可以在指定的tag
上发布版本,而使用者可以选择指定的tag
来安装包。不同的标签下的版本之间互不影响,这在发布者发布预发布版本包和使用者尝鲜预发布版本包的同时,不影响到正式版本。
在发布包的时候执行npm publish
默认会打上latest
这个tag
,实际上是执行了npm publish --tag latest
。而在安装包的时候执行npm install xxx
则会默认下载latest
这个tag
下面的最新版本,实际上是执行了npm install xxx@latest
。当然,我们也可以自定义tag
:
# 当前版本为1.0.1npm version prerelease # 1.0.2-0npm publish --tag betanpm dist-tag ls xxx # # beta: 1.0.2-0npm install xxx@beta # 下载beta版本 1.0.2-0
npm version prerelease # 1.0.2-0
npm publish --tag beta
npm dist-tag ls xxx # # beta: 1.0.2-0
npm install xxx@beta # 下载beta版本 1.0.2-0
当prerelease
版本已经稳定了,可以将prerelease
版本设置为稳定版本:
npm dist-tag add [email protected] latestnpm dist-tag ls xxx # latest: 1.0.2-0# latest: 1.0.2-0
细心的同学会发现,在package.json
中的依赖有两种形式:
"devDependencies": { "@commitlint/cli": "^7.2.1", "commitizen": "^3.0.4"}
"@commitlint/cli": "^7.2.1",
"commitizen": "^3.0.4"
}
其中以@
开头的包名,是一个域级包(scoped package),这种域级包的作用是将一些packages
集中在一个命名空间下,一方面可以集中管理,一方面可以防止与别的包产生命名冲突。
要发布域级包,首先要在项目的package.json
的name
属性中添加scope
相关的声明,可以通过指令添加:
npm init --scope=scopeName -y
package.json
变为:
{ "name": "@scopeName/package"}"name": "@scopeName/package"
}
可以将用户名作为域名,也可以将组织名作为域名。
由于用@
声明了该包,npm
会默认将此包认定为私有包,而在npm
上托管私有包是需要收费的,所以为了避免发布私有包,可以在发布时添加--accss=public
参数告知npm
这不是一个私有包:
npm publish --access=public
域级包不一定就是私有包,但是私有包一定是一个域级包。
同时,在安装域级包时需要按照域级包全名来安装:
npm install @scopeName/package
使用npm init
初始化一个新的项目时会提示你去填写一些项目描述信息。如果觉得填写这些信息比较麻烦的话,可以使用-y
标记表示接受package.json
中的一些默认值:
npm init -y
也可以设置初始化的默认值:
npm config set init-author-name // 为 npm init 设置了默认的作者名
查看当前项目的所有npm
脚本命令最直接的办法就是打开项目中的package.json
文件并检查scripts
字段。我们还可以使用不带任何参数的npm run
命令查看:
npm run
通过env
查看当前的所有环境变量,而查看运行时的所有环境变量可以执行:
npm run env
检查当前项目依赖的所有模块,包括子模块以及子模块的子模块:
npm list/ls
如果还想查看模块的一些描述信息(package.json
中的description
中的内容):
npm la/ll // 相当于npm ls --long
一个项目依赖的模块往往很多,可以限制输出模块的层级来查看:
npm list/ls --depth=0 // 只列出父包依赖的模块
检查项目中依赖的某个模块的当前版本信息:
npm list/ls
查看某个模块包的版本信息:
npm view/info version // 模块已经发布的最新的版本信息(不包括预发布版本)npm view/info versions // 模块所有的历史版本信息(包括预发布版本)
查看一个模块到底是因为谁被安装进来的,如果显示为空则表明该模块为内置模块或者不存在:
npm ll
查看某个模块的所有信息,包括它的依赖、关键字、更新日期、贡献者、仓库地址和许可证等:
npm view/info
查看当前项目中可升级的模块:
npm outdated
整理项目中无关的模块:
npm prune
打开模块的 github 主页:
npm repo
打开模块的文档地址:
npm docs
打开模块的 issues 地址:
npm bugs
你的文件夹中肯定存在很多应用程序,而当你想要启动某个应用程序时,肯定是通过cd
指令一步步进入到你所想要启动的应用程序目录下,然后再执行启动命令。npm
提供了--prefix
可以指定启动目录:
npm run dev --prefix /path/to/your/folder
假设你在开发一个模块A
,同时需要在另外一个项目B
中测试它,当然你可以将该模块的代码拷贝到需要使用它的项目中,但这也不是理想的方法,可以在模块A
的目录下执行:
npm link
npm link
命令通过链接目录和可执行文件,实现任意位置的npm
包命令的全局可执行。
npm link
主要做了两件事:
为目标npm
模块创建软链接,将其链接到全局node
模块安装路径/usr/local/lib/node_modules/
为目标npm
模块的可执行bin
文件创建软链接,将其链接到全局node
命令安装路径/usr/local/bin/
检查项目中是否存在具有安全漏洞的依赖包,如果存在,则将生成其漏洞报告显示在控制台中:
npm audit [--json] # 加上--json,以 JSON 格式生成漏洞报告# 加上--json,以 JSON 格式生成漏洞报告
npm
升级到6.x
版本以后,在项目中更新或者下载新的依赖包以后会自动执行 npm audit 命令,对项目依赖包进行安全检查,如果存在安全漏洞,将生成漏洞报告并在控制台中显示。
修复存在安全漏洞的依赖包(自动更新到兼容的安全版本):
npm audit fix
执行npm audit fix
能修复大部分存在安全漏洞的依赖包,对于一些没能自动修复漏洞的依赖包,说明出现了SERVER WARNING
之类的警告(主要发生在依赖包更改了不兼容的api
或者大版本做了升级的情况下),这意味着推荐的修复版本还可能出现问题,这时可以执行如下命令来修复这些依赖包:
npm audit fix --force
--force
会将依赖包版本号升级到最新的大版本,而不是兼容的安全版本。大版本的升级可能会出现一些不兼容的用法,所以尽量避免使用--force
。
如果执行npm audit fix --force
后还是存在有安全漏洞的依赖包,手动执行npm audit
打印出还存在安全漏洞的依赖包的具体信息,其中More info
对应的链接中可能给出了解决方案。
如果想知道audit fix
会怎么处理项目中的依赖包,可以预先查看:
npm audit fix --dry-run --json
如果只想修复生产环境的依赖包(只更新dependencies
中的依赖包,不更新devDependencies
中的依赖包):
npm audit --only=prod
如果不想修复依赖包,只修改package-lock.json
文件:
npm audit fix --package-lock-only
如果想安装某个包时不进行安全漏洞检查:
npm install packageName --no-auditno-audit
要想安装所有包时都不进行安全漏洞检查,则可以修改npm
配置:
npm config set audit falseaudit false
npm
默认安装模块时,会通过脱字符^
来限定所安装模块的主版本号。可以配置npm
通过波浪符~
来限定安装模块版本号:
npm config set save-prefix="~""~"
当然还可以配置npm
仅安装精确版本号的模块:
npm config set save-exact truetrue
关于npm
的知识点暂时总结到这里,可能还有很多方面没有总结到位,后续如果还有新的知识点会随时更新,也欢迎各位大佬们随时来补充,共同进步!