npx 使用教程

作者: 阮一峰

日期: 2019年2月 9日

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 [email protected] 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 [email protected] -v
v0.12.8

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

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

-p 参数

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


$ npx -p [email protected] node -v 
v0.12.8

上面命令先指定安装[email protected],然后再执行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和入口脚本。

参考链接

(完)

留言(23条)

我第一次知道“阮一峰”是在五天前,我想制作一个外挂脚本。后来,我发现也许我能够做一些更有意义的事情。我喜欢的东西很多,这两天只要不在拜年,我经常会点开一些日志看看。虽然很多东西我都不懂,但却觉得很神奇。阮一峰先生,我是一个偶然路过的学生,我想和您学一些东西。不知道具体应该是学习什么,因为您的日志似乎有些杂(应该是广泛吧,不过恰好我也是有一个喜欢“杂”的人),我想先学一些有关于计算机方面的知识。

多谢阮老师,受教

前段时间刚好用 npx 命令发布了一个 npm package:npx force-unpublish package-name '取消发布该 package 的原因'。

引用柳孤城的发言:

我第一次知道“阮一峰”是在五天前,我想制作一个外挂脚本。后来,我发现也许我能够做一些更有意义的事情。我喜欢的东西很多,这两天只要不在拜年,我经常会点开一些日志看看。虽然很多东西我都不懂,但却觉得很神奇。阮一峰先生,我是一个偶然路过的学生,我想和您学一些东西。不知道具体应该是学习什么,因为您的日志似乎有些杂(应该是广泛吧,不过恰好我也是有一个喜欢“杂”的人),我想先学一些有关于计算机方面的知识。

好好读书,考个好大学

@柳孤城:

好好读书,考个好大学

npx好用

对您的大作——http://www.ruanyifeng.com/road/2011/2011-08-01-papers.html有些意见,阮先生的观点很有见地,但假如论文成了全人类的版权,只剩下普世价值而没有世俗意义上的商业价值,它对创作者的吸引力可能大大下降。也就是说,只为了普及知识,对作者的生存发展几乎没有帮助。那么,这样的论文创作者能有多少?

阮老师,有办法同时使用npx和cnpm吗,直接用npx是用的国外的镜像吧

有空就看大佬的文章,受益匪浅

进来都进来了,给阮老师点点广告吧

解除广告屏蔽插件后仍然显示请屏蔽广告插件,应该如何解决?
系统环境是macOS 10.14,Safari,ADGuard
会先看到内容一闪而过然后变成广告屏蔽提示

引用撕葱大表哥的发言:

阮老师,有办法同时使用npx和cnpm吗,直接用npx是用的国外的镜像吧

切换npm的镜像源
npm config set registry https://registry.npm.taobao.org

npm 很好用

引用关中刀客在青岛的发言:

切换npm的镜像源
npm config set registry https://registry.npm.taobao.org

直接使用nrm 吧
安装:npm i nrm -g
nrm use taobao

nvm可以实现切换node版本后进行一系列操作,npx如何实现呢?每个命令都需要带npx node@xxx?

一般来说npm/npx安装的不是模块(module),而是包(package),参数-p中p应该指的是package的缩写。在node学习中,关于模块和包的概念有些模糊,看似可以视为同一概念,其实在我看来是有一定区分的。在npm中,大部分包都会有一个package.json文件,这些包都是以文件夹形式存在的,例如大家熟知的vue-router等。而在webpack的配置文件中,loader是放在module字段下的,而loader加载的module一般是单个文件,如test.png,index.css等文件。
可以认为,模块(module)只是一个单独文件,没有package.json文件;而包(package)是一个文件夹,包含package.json文件。

顺带提一句,package.json是commonjs中的规范,而npm是commonjs的实践。同时,在js中万物皆对象(object),在nodejs中万物皆模块(module),当然这句只是调侃哈哈。

# 项目的根目录下执行
$ node_modules/.bin/typedoc --version

node_moudles是下划线,

不知道什么时候开始看的阮老师的文章,印象深刻的是那片flex布局的吧,作为一名开发者,有空就来看看。

阮老师,那npx执行的具体是package.json的哪条命令啊

不知道npm搞什么鬼,npx流行起来不容易,刚感觉好用,现在竟然被废弃了。。。。。

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

我试的是不会重新下载, 好像是一直保留缓存,当npm版本更新后,再用npx,它会提示是否下载

-c参数那一节,关于 localcatjs lolcatjs 两者的拼写一致性好像有出入了

你好,请问一下你这里所说的 “会到node_modules/.bin路径和环境变量$PATH里面,检查命令是否存在。” 中的环境变量$PATH指的是什么?是指 我的电脑 里的 高级系统设置 里的 环境变量 吗?

我要发表看法

«-必填

«-必填,不公开

«-我信任你,不会填写广告链接