Grunt.js 是一個 JavaScript Task Runner(JavaScript 任務運行器),它基於 Node.js,是一套可用於自動化建置、測試、產生文件的專案管理工具。
Grunt.js 並不只是建置工具。準確來說,它是任務運行器——負責管理每個子任務的自動化執行,因此我們能用它做的事情遠比「打包」多得多。
簡單說:為了自動化。對一個前端專案而言,我們常常面對這些需求:
很明顯,這一切都有各式各樣的小工具能幫我們做到。但我們真正想要的是:輸入一個指令、開啟一個程式,或者乾脆每次存檔後就自動跑完這一切。以前我們可能得自己用 Node.js 寫一支 build 程式,而 Grunt.js 把我們需要的東西都備齊了。
Grunt.js 0.4 之後不再以全域方式安裝整個 Grunt,而是改為在全域安裝 Grunt.js Client,再於當前專案中安裝 Grunt,藉此避免未來不同專案對 Grunt 不同版本的依賴衝突。
如果先前裝過舊版本,可以先用 npm 指令移除:
npm uninstall -g grunt
接著安裝 Grunt.js Client:
npm install -g grunt-cli
package.json 是專案的設定檔,記錄專案的依賴資訊以及作者、版本等資料。先寫一個最簡單的版本:
{
"name": "my-project",
"version": "0.1.0",
"devDependencies": {
"grunt": "~0.4.1"
}
}
其中 name 表示該專案的名稱;version 是版本號;devDependencies 則包含專案的開發依賴,目前我們只依賴 grunt,版本為 0.4.1。
在終端機中切到包含該 package.json 的目錄,執行:
npm install
你會發現該目錄多了一個 node_modules 資料夾,裡面有個 grunt 資料夾,這就是安裝在專案內的 Grunt.js。
grunt-contrib-uglify 是 Grunt.js 的一個任務模組,它基於著名的 js 壓縮工具 uglify 來執行壓縮任務。
首先在專案依賴中加上它:
{
"name": "my-project",
"version": "0.1.0",
"devDependencies": {
"grunt": "~0.4.1",
"grunt-contrib-uglify": "~0.2.0"
}
}
再執行一次:
npm install
這樣就裝好 grunt-contrib-uglify 了。
module.exports = function (grunt) {
// 給 grunt 添加一些設定
grunt.initConfig({
uglify: {
options: {
banner: '/*! 版權所有,這裡亂寫 */\n'
},
build: {
src: 'src/core.js', // 要壓縮的來源檔案,也可用 * 通配,例如 'src/*.js'
dest: 'dst/core.js' // 壓縮後輸出的位置
}
}
});
// 載入 "uglify" 外掛任務
grunt.loadNpmTasks('grunt-contrib-uglify');
// 定義預設需要執行的任務
grunt.registerTask('default', ['uglify']);
};
Gruntfile.js 用於定義任務以及任務組的執行順序。上面的檔案定義了「把 src/core.js 壓縮後輸出成 dst/core.js」,因此當我們執行:
grunt
它就會自動完成這個任務。
這套「package.json 宣告依賴 + Gruntfile.js 定義任務」的結構,開啟了前端建置自動化的時代,但它以設定為中心的風格也為人詬病:設定檔往往越寫越長,任務之間的串接靠宣告式組態表達,複雜流程讀起來並不直覺。
因此社群後來出現了以「程式碼為中心」的 Gulp,以及把一切都當成可組合函式的 Webpack 與 Vite。今日若要開新專案,Grunt 已相對少見,但它所確立的觀念——建置步驟應該被宣告、被自動執行、被版本控制——至今仍是前端工程的基礎。理解 Grunt 的運作方式,能幫助你看懂許多老專案的 Gruntfile,也能讓你在改用任何新工具時,知道自己在組装的其實是同一件事。