Node 自带 npm 模块,所以可以直接使用 npx 命令。万一不能用,就要手动安装一下。
1 | npm install -g npx |
调用项目安装的模块
npx 想要解决的主要问题,就是调用项目内部安装的模块。比如,项目内部安装了测试工具 Mocha。
1 | npm install -D mocha |
一般来说,调用 Mocha
,只能在项目脚本和 package.json
的scripts字段里面, 如果想在命令行下调用,必须像下面这样。
1 | 项目的根目录下执行 |
npx
就是想解决这个问题,让项目内部安装的模块用起来更方便,只要像下面这样调用就行了。
1 | $ npx mocha --version |
npx
的原理很简单,就是运行的时候,会到node_modules/.bin
路径和环境变量$PATH
里面,检查命令是否存在。
由于 npx
会检查环境变量$PATH
,所以系统命令也可以调用。
1 | 等同于 ls |
注意,Bash
内置的命令不在$PATH
里面,所以不能用。比如,cd
是 Bash
命令,因此就不能用npx cd
。
避免全局安装模块
除了调用项目内部模块,npx
还能避免全局安装的模块。比如,create-react-app
这个模块是全局安装,npx
可以运行它,而且不进行全局安装。
1 | npx create-react-app my-react-app |
上面代码运行时,npx
将create-react-app
下载到一个临时目录,使用以后再删除。所以,以后再次执行上面的命令,会重新下载create-react-app
。
下载全局模块时,npx
允许指定版本。
1 | npx uglify-js@3.1.0 main.js -o ./dist/main.js |
上面代码指定使用 3.1.0
版本的uglify-js
压缩脚本。
注意,只要 npx
后面的模块无法在本地发现,就会下载同名模块。比如,本地没有安装http-server
模块,下面的命令会自动下载该模块,在当前目录启动一个 Web
服务。
1 | npx http-server |
–no-install 参数和–ignore-existing 参数
如果想让 npx
强制使用本地模块,不下载远程模块,可以使用--no-install
参数。如果本地不存在该模块,就会报错。
1 | npx --no-install http-server |
反过来,如果忽略本地的同名模块,强制安装使用远程模块,可以使用--ignore-existing
参数。比如,本地已经全局安装了create-react-app
,但还是想使用远程模块,就用这个参数。
1 | npx --ignore-existing create-react-app my-react-app |
使用不同版本的 node
利用 npx
可以下载模块这个特点,可以指定某个版本的 Node
运行脚本。它的窍门就是使用 npm
的 node 模块
。
1 | npx node@0.12.8 -v |
上面命令会使用 0.12.8
版本的 Node
执行脚本。原理是从 npm
下载这个版本的 node
,使用后再删掉。
某些场景下,这个方法用来切换 Node
版本,要比 nvm
那样的版本管理器方便一些。
-p 参数
-p
参数用于指定 npx
所要安装的模块,所以上一节的命令可以写成下面这样。
1 | npx -p node@0.12.8 node -v |
上面命令先指定安装`node@0.12.8,然后再执行
node -v`命令。
-p
参数对于需要安装多个模块的场景很有用。
1 | npx -p lolcatjs -p cowsay [command] |
-c 参数
如果 npx
安装多个模块,默认情况下,所执行的命令之中,只有第一个可执行项会使用 npx
安装的模块,后面的可执行项还是会交给 Shell
解释。
1 | npx -p lolcatjs -p cowsay 'cowsay hello | lolcatjs' |
上面代码中,cowsay hello | lolcatjs
执行时会报错,原因是第一项cowsay
由 npx
解释,而第二项命令localcatjs
由 Shell
解释,但是lolcatjs
并没有全局安装,所以报错。
-c
参数可以将所有命令都用 npx
解释。有了它,下面代码就可以正常执行了。
1 | npx -p lolcatjs -p cowsay -c 'cowsay hello | lolcatjs' |
-c
参数的另一个作用,是将环境变量带入所要执行的命令。举例来说,npm
提供当前项目的一些环境变量,可以用下面的命令查看。
1 | npm run env | grep npm_ |
-c
参数可以把这些 npm
的环境变量带入 npx
命令。
1 | npx -c 'echo "$npm_package_name"' |
上面代码会输出当前项目的项目名。
执行 GitHub 源码
npx
还可以执行 GitHub
上面的模块源码。
1 | 执行 Gist 代码 |
注意,远程代码必须是一个模块,即必须包含package.json
和入口脚本。