npx使用方法_npx安装

1. Why：为什么要用npx？

• 解决项目内部模块使用不方便的问题
• 避免全局安装模块

2. What：什么是npx？

• npx 命令是npm 从5.2版开始增加的命令 。
• npx 想要解决的主要问题，就是方便调用项目内部安装的模块

3. How：npx的用法

3.1 安装npx

$ npm install -g npx
1

3.2 npx使用项目内部的模块

npx 想要解决的主要问题，就是调用项目内部安装的模块。比如，项目内部安装了测试工具 Mocha。

$ npm install -D mocha
1

一般来说，调用 Mocha ，只能在项目脚本和 package.json 的 scripts字段里面， 如果想在命令行下调用，必须像下面这样。

# 项目的根目录下执行
$ node-modules/.bin/mocha --version
1
2

而使用了npx以后，直接像下面这样写就行。

$ npx mocha --version
1

npx 的原理很简单，就是运行的时候，会到node_modules/.bin路径和环境变量$PATH里面，检查命令是否存在。

由于 npx 会检查环境变量$PATH，所以系统命令也可以调用。

注意，Bash 内置的命令不在$PATH里面，所以不能用。比如，cd是 Bash 命令，因此就不能用npx cd。

3.3 使用npx避免全局安装模块

3.3.1 使用模块方法

对于需要全局安装的模块，使用npx可以让模块无需全局安装也可使用。

比如，create-react-app这个模块是全局安装，npx 可以运行它，而且不进行全局安装。

$ npx create-react-app my-react-app
1

上面代码运行时，npx 将create-react-app下载到一个临时目录，使用以后再删除。所以，以后再次执行上面的命令，会重新下载create-react-app。

3.3.2 指定模块版本使用模块

下面代码指定使用 3.1.0 版本的uglify-js压缩脚本

$ npx uglify-js@3.1.0 main.js -o ./dist/main.js
1

注意，只要 npx 后面的模块无法在本地发现，就会下载同名模块

3.4 强制使用本地或远程模块

3.4.1 强制使用本地模块

使用--no-install参数。如果本地不存在该模块，就会报错。

$ npx --no-install http-server
1

3.4.2 强制使用远程模块

使用--ignore-existing参数，忽略本地的同名模块，强制安装使用远程模块。

$ npx --ignore-existing create-react-app my-react-app
1

3.5 其它参数用法

3.5.1 -p 参数

• 指定npx所要安装的模块

-p参数用于指定 npx 所要安装的模块，所以上一节的命令可以写成下面这样

$ npx -p node@0.12.8 node -v
v0.12.8
1
2

上面命令先指定安装node@0.12.8，然后再执行node -v命令。

-p参数对于需要安装多个模块的场景很有用.

$ npx -p lolcatjs -p cowsay [command]
1

3.5.2 -c 参数

• 将所有命令都用 npx 解释
• 将环境变量带入所要执行的命令

如果 npx 安装多个模块，默认情况下，所执行的命令之中，只有第一个可执行项会使用 npx 安装的模块，后面的可执行项还是会交给 Shell 解释。

$ npx -p lolcatjs -p cowsay 'cowsay hello | lolcatjs'
# 报错
1
2

上面代码中，cowsay hello | lolcatjs执行时会报错，原因是第一项cowsay由 npx 解释，而第二项命令localcatjs由 Shell 解释，但是lolcatjs并没有全局安装，所以报错。

-c参数可以将所有命令都用 npx 解释。有了它，下面代码就可以正常执行了。

$ npx -p lolcatjs -p cowsay -c 'cowsay hello | lolcatjs'
1

-c参数的另一个作用，是将环境变量带入所要执行的命令。

$ npx -c 'echo "$npm_package_name"'
1

上面代码会输出当前项目的项目名。

3.6 npx的使用技巧

3.6.1 使用不同版本的 node

利用 npx 可以下载模块这个特点，可以指定某个版本的 Node 运行脚本。它的窍门就是使用 npm 的 node 模块。

$ npx node@0.12.8 -v
v0.12.8
1
2

上面命令会使用 0.12.8 版本的 Node 执行脚本。原理是从 npm 下载这个版本的 node，使用后再删掉。

某些场景下，这个方法用来切换 Node 版本，要比 nvm 那样的版本管理器方便一些。

3.6.2 执行 GitHub 源码

npx 还可以执行 GitHub 上面的模块源码。

# 执行 Gist 代码
$ npx https://gist.github.com/zkat/4bc19503fe9e9309e2bfaa2c58074d32

# 执行仓库代码
$ npx github:piuccio/cowsay hello
1
2
3
4
5

注意，远程代码必须是一个模块，即必须包含package.json和入口脚本。

整理自：阮一峰 《npx使用教程》 http://www.ruanyifeng.com/

• 版权声明：自由转载-非商用-非衍生-保持署名（创意共享3.0许可证）
• 发表日期：2022年2月8日