总结
- 了解并学会了如何使用下载工具 curl
- 了解如何设置 Path 环境变量(控制面板 -> 系统和安全 -> 系统 -> 高级系统设置)
- nvm 设置 node 或 nvm 镜像(用来下载 node 的源、用来下载项目依赖的源)
- 文件路径中
~
符号的含义 - node 历史版本获取链接
- nvm-windows 常用命令
- 依赖缓存的获取
- npm 脚本的执行原理
- .npmrc 配置文件作用
一开始在 github 上找到 nvm 这个仓库。然后就按照 readme 文档,先下载了一个下载工具 curl,然后再用 curl 来下载 nvm 这个仓库。再然后,出现了一些问题,就顺带复习或学习了其它的技能。
安装 nvm
首先下载 curl (windows 版),下载后解压缩,将解压缩后的目录添加到系统的 Path 环境变量中。
然后执行脚本:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
这个脚本会把 nvm 仓库下载到目录 ~/.nvm
中,(~
在 Unix 系统中表示用户的 home 目录,在 windows 就表示随便一个被指定了的目录了)
然后将下列代码添加到 ~/.bashrc
文件中并执行。(如果不存在 ~/.bashrc
文件,需要自己创建下,否则会安装失败)
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
验证是否安装成功
command -v nvm
最后是成功了的,但是使用起来非常卡,而且有时候切换 node 版本不成功。于是我又发现了 nvm-windows,使用起来更加的迅捷,流程。
安装 nvm-windows
https://github.com/coreybutler/nvm-windows/releases
nvm-windows 常用命令
# 安装某个版本
nvm install 14.7.0 # or 16.3.0, 12.22.1, etc
# 获取远程可用版本
nvm ls available
nvm list available
# 使用某个版本
nvm use xx.x.x
# 获取本地的可用版本
nvm ls
nvm list
node 版本列表
https://nodejs.org/en/download/releases
镜像
设置 node 镜像,加速 node 的下载。在中国可以使用 https://npmmirror.com/mirrors/node/
nvm node_mirror <node_mirror_url>
设置 npm 镜像,加速项目依赖的下载。在中国可以使用 https://npmmirror.com/mirrors/npm/
nvm npm_mirror <npm_mirror_url>
原镜像
https://registry.npmjs.org
淘宝最新镜像
https://registry.npmmirror.com
获取镜像
npm config get registry
切换镜像
npm config set registry https://registry.npmmirror.com
下载时指定镜像
npm install -g cnpm --registry=https://registry.npmmirror.com
缓存
如果存在损坏的文件,清空缓存
npm cache clean -f
查看缓存的包
npm cache ls
# 如果只想看全局缓存的包
npm cache ls -g
查看缓存所在的位置
npm config get cache
查看是否还有缓存
npm cache verify
npm 脚本
定义在package.json里面的脚本,就称为 npm 脚本
执行原理
每当执行npm run,就会自动新建一个 Shell,在这个 Shell 里面执行指定的脚本命令。
因此,只要是 Shell(Bash)可以运行的命令,就可以写在 npm 脚本里面。
比较特别的是,npm run 新建的这个 Shell,会将当前目录的 node_modules/.bin 子目录加入 PATH 变量,执行结束后,再将 PATH 变量恢复原样。
这意味着,当前目录的 node_modules/.bin 子目录里面的所有脚本,都可以直接用脚本名调用,而不必加上路径。比如,当前项目的依赖里面有 Mocha,只要直接写mocha test 就可以了。
"test": "mocha test"
而不用写成下面这样。
"test": "./node_modules/.bin/mocha test"
由于 npm 脚本的唯一要求就是可以在 Shell 执行,因此它不一定是 Node 脚本,任何可执行文件都可以写在里面。npm 脚本的退出规则,也遵守 Shell 脚本规则。如果退出码不是 0,npm 就认为这个脚本执行失败。
通配符
由于 npm 脚本就是 Shell 脚本,因为可以使用 Shell 通配符。
"lint": "jshint *.js"
"lint": "jshint **/*.js"
上面代码中,* 表示任意文件名,** 表示任意一层子目录。
如果要将通配符传入原始命令,防止被 Shell 转义,要将星号转义。
"test": "tap test/\*.js"
传参
向 npm 脚本传入参数,要使用–标明。
执行顺序
如果 npm 脚本里面需要执行多个任务,那么需要明确它们的执行顺序。
如果是并行执行(即同时的平行执行),可以使用 & 符号。
npm run script1.js & npm run script2.js
如果是继发执行(即只有前一个任务成功,才执行下一个任务),可以使用 && 符号。
npm run script1.js && npm run script2.js
这两个符号是 Bash 的功能。此外,还可以使用 node 的任务管理模块:script-runner、npm-run-all、redrun。
变量
通过 npm_package_ 前缀,npm 脚本可以拿到 package.json 里面的字段。比如,下面是一个 package.json。
{
"name": "foo",
"version": "1.2.5",
"scripts": {
"view": "node view.js"
}
}
那么,变量 npm_package_name 返回 foo,变量 npm_package_version 返回 1.2.5。
// view.js
console.log(process.env.npm_package_name); // foo
console.log(process.env.npm_package_version); // 1.2.5
上面代码中,我们通过环境变量 process.env 对象,拿到 package.json 的字段值。
如果是 Bash 脚本,可以用 $npm_package_name 和 $npm_package_version 取到这两个值。
npm_package_ 前缀也支持嵌套的 package.json 字段。
"repository": {
"type": "git",
"url": "xxx"
},
scripts: {
"view": "echo $npm_package_repository_type"
}
上面代码中,repository 字段的 type 属性,可以通过 npm_package_repository_type 取到。
下面是另外一个例子。
"scripts": {
"install": "foo.js"
}
上面代码中,npm_package_scripts_install 变量的值等于 foo.js。
然后,npm 脚本还可以通过 npm_config_ 前缀,拿到 npm 的配置变量,即 npm config get xxx 命令返回的值。比如,当前模块的发行标签,可以通过npm_config_tag 取到。
"view": "echo $npm_config_tag",
注意,package.json 里面的 config 对象,可以被环境变量覆盖。
{
"name" : "foo",
"config" : { "port" : "8080" },
"scripts" : { "start" : "node server.js" }
}
上面代码中,npm_package_config_port 变量返回的是 8080。这个值可以用下面的方法覆盖。
npm config set foo:port 80
最后,env 命令可以列出所有环境变量。
"env": "env"
常用脚本
// 删除目录
"clean": "rm -rf dist && mkdir dist",
// 本地搭建一个 HTTP 服务
"serve": "http-server -p 9090 dist/",
// 打开浏览器
"open:dev": "opener http://localhost:9090",
.npmrc 配置文件作用
- 定义项目依赖的安装源
- 可以设置代理服务器(你的计算机和互联网中间的一台机器)
- 设置 npm 缓存的位置
- 配置私有仓库的认知信息
- 配置 npm 的默认行为,是否允许覆盖本地包
.npmrc 文件会向上查找,下面的会覆盖上面的。