npx 使用教程

npm 从5.2版开始，增长了 npx 命令。它有不少用处，本文介绍该命令的主要使用场景。

Node 自带 npm 模块，因此能够直接使用 npx 命令。万一不能用，就要手动安装一下。

$ npm install -g npx

调用项目安装的模块

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

$ npm install -D mocha

通常来讲，调用 Mocha ，只能在项目脚本和 package.json 的scripts字段里面， 若是想在命令行下调用，必须像下面这样。

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

npx 就是想解决这个问题，让项目内部安装的模块用起来更方便，只要像下面这样调用就好了。

$ npx mocha --version

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

因为 npx 会检查环境变量$PATH，因此系统命令也能够调用。

# 等同于 ls
$ npx ls

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

避免全局安装模块

除了调用项目内部模块，npx 还能避免全局安装的模块。好比，create-react-app这个模块是全局安装，npx 能够运行它，并且不进行全局安装。

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

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

下载全局模块时，npx 容许指定版本。

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

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

注意，只要 npx 后面的模块没法在本地发现，就会下载同名模块。好比，本地没有安装http-server模块，下面的命令会自动下载该模块，在当前目录启动一个 Web 服务。

$ npx http-server

--no-install 参数和--ignore-existing 参数

若是想让 npx 强制使用本地模块，不下载远程模块，可使用--no-install参数。若是本地不存在该模块，就会报错。

$ npx --no-install http-server

反过来，若是忽略本地的同名模块，强制安装使用远程模块，可使用--ignore-existing参数。好比，本地已经全局安装了create-react-app，但仍是想使用远程模块，就用这个参数。

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

使用不一样版本的 node

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

$ npx node@0.12.8 -v
v0.12.8

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

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

-p 参数

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

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

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

-p参数对于须要安装多个模块的场景颇有用。

$ npx -p lolcatjs -p cowsay [command]

-c 参数

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

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

上面代码中，cowsay hello | lolcatjs执行时会报错，缘由是第一项cowsay由 npx 解释，而第二项命令localcatjs由 Shell 解释，可是lolcatjs并无全局安装，因此报错。

-c参数能够将全部命令都用 npx 解释。有了它，下面代码就能够正常执行了。

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

-c参数的另外一个做用，是将环境变量带入所要执行的命令。举例来讲，npm 提供当前项目的一些环境变量，能够用下面的命令查看。

$ npm run env | grep npm_

-c参数能够把这些 npm 的环境变量带入 npx 命令。

$ npx -c 'echo "$npm_package_name"'

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

执行 GitHub 源码

npx 还能够执行 GitHub 上面的模块源码。

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

# 执行仓库代码
$ npx github:piuccio/cowsay hello

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