Node 開發離不開 npm，而腳本功能是 npm 最強大、最常用的功能之一。

本文介紹如何使用 npm 腳本（npm scripts）。

一、什么是 npm 腳本？

npm 允許在package.json文件里面，使用scripts字段定義腳本命令。

{ // ... "scripts": {  "build": "node build.js" }}

上面代碼是package.json文件的一個片段，里面的scripts字段是一個對象。它的每一個屬性，對應一段腳本。比如，build命令對應的腳本是node build.js。

命令行下使用npm run命令，就可以執行這段腳本。

$ npm run build# 等同于執行$ node build.js

這些定義在package.json里面的腳本，就稱為 npm 腳本。它的優點很多。

查看當前項目的所有 npm 腳本命令，可以使用不帶任何參數的npm run命令。

$ npm run

二、原理

npm 腳本的原理非常簡單。每當執行npm run，就會自動新建一個 Shell，在這個 Shell 里面執行指定的腳本命令。因此，只要是 Shell（一般是 Bash）可以運行的命令，就可以寫在 npm 腳本里面。

比較特別的是，npm run新建的這個 Shell，會將當前目錄的node_modules/.bin子目錄加入PATH變量，執行結束后，再將PATH變量恢復原樣。

這意味著，當前目錄的node_modules/.bin子目錄里面的所有腳本，都可以直接用腳本名調用，而不必加上路徑。比如，當前項目的依賴里面有 Mocha，只要直接寫mocha test就可以了。

"test": "mocha test"

而不用寫成下面這樣。

"test": "./node_modules/.bin/mocha test"

由于 npm 腳本的唯一要求就是可以在 Shell 執行，因此它不一定是 Node 腳本，任何可執行文件都可以寫在里面。

npm 腳本的退出碼，也遵守 Shell 腳本規則。如果退出碼不是0，npm 就認為這個腳本執行失敗。

三、通配符

由于 npm 腳本就是 Shell 腳本，因為可以使用 Shell 通配符。

"lint": "jshint *.js""lint": "jshint **/*.js"

上面代碼中，*表示任意文件名，**表示任意一層子目錄。

如果要將通配符傳入原始命令，防止被 Shell 轉義，要將星號轉義。

"test": "tap test//*.js"

四、傳參

向 npm 腳本傳入參數，要使用--標明。

"lint": "jshint **.js"

向上面的npm run lint命令傳入參數，必須寫成下面這樣。

$ npm run lint -- --reporter checkstyle > checkstyle.xml