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

三、使用不同版本的 node

利用 npx 可以下載模塊這個特點,可以指定某個版本的 Node 運行腳本。它的竅門就是使用 npm 的 node 模塊

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

上面命令會使用 0.12.8 版本的 Node 執行腳本。原理是從 npm 下載這個版本的 node,使用后再刪掉。

某些場景下,這個方法用來切換 Node 版本,要比 nvm 那樣的版本管理器方便一些

四、執行 GitHub 源碼

npx 還可以執行 GitHub 上面的模塊源碼。

// 執行 Gist 代碼
$ npx https://gist.github.com/zkat/4bc19503fe9e9309e2bfaa2c58074d32

// 執行倉庫代碼
$ npx github:piuccio/cowsay hello

注意,遠程代碼必須是一個模塊,即必須包含package.json和入口腳本。

五、npx相關參數解讀

5.1、--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 

5.2、-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]

5.3、-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"'

上面代碼會輸出當前項目的項目名。

轉自:http://www.ruanyifeng.com/blog/2019/02/npx.html


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM