自己寫了一個 HTML5 Canvas 的圖表庫,支援圓餅圖、折線圖、散點圖、盒狀圖、柱狀圖,還有滑鼠提示與繪製動畫。功能都寫完了,卻卡在一個看似簡單的問題上:這些拆成好幾個的 JS 檔,要怎麼合併成一個再發布?
社群裡有人跟我說:用 GruntJS 啊,JavaScript 多檔編譯、風格檢查、合併與壓縮神器。查了一下文件,確實把這件事做完了。以下記錄整個流程,算是入門筆記。
它是一個 JavaScript 的任務執行器(task runner),本身跑在 Node.js 上。你把「要做的事」寫成設定檔,再用指令觸發。常見用途包括合併檔案、壓縮、語法檢查、編譯 Sass、監看檔案變動自動重跑等。
官方文件的說明對第一次接觸的人不太友善,容易看得雲裡霧裡。整理成三步:
第一步:安裝 Node.js。Grunt 依賴 Node 環境,所以要先裝好。下載點是 nodejs.org/download。
第二步:安裝 grunt 命令列工具。目的是為了能在終端機使用 grunt 這個指令。在 Windows 的命令列視窗中執行:
npm install -g grunt-cli
注意 -g 代表全域安裝。更完整的說明可參考 gruntjs.com/getting-started。
第三步:在專案根目錄建立兩個檔案。Grunt 的 task 完全依賴這兩個檔案:package.json 與 Gruntfile.js。
package.json 可以用指令產生:npm init。過程中不確定怎麼填的直接按 Enter 跳過就好,事後再改。內容大致如下:
{
"name": "fishchart",
"version": "0.0.1",
"description": "html5 canvas chart library",
"author": "zhigang",
"license": "BSD",
"devDependencies": {
"grunt": "~0.4.1",
"grunt-contrib-uglify": "~0.2.2",
"grunt-contrib-jshint": "~0.6.2",
"grunt-contrib-concat": "~0.3.0"
}
}
devDependencies 底下列的,就是這個專案開發時需要的工具。前綴 grunt-contrib- 是官方 plugin 的命名慣例。
// 安裝合併支援
npm install grunt-contrib-concat --save-dev
// 安裝壓縮支援
npm install grunt-contrib-uglify --save-dev
--save-dev 會自動把這些相依套件寫進 package.json 的 devDependencies,下次別人 clone 你的專案只要跑 npm install 就能還原環境。
module.exports = function(grunt) {
grunt.initConfig({
// JSHint 設定:要檢查哪些檔案
jshint: {
all: ['main.js']
},
// 合併設定
concat: {
options: {
separator: ';' // 用分號隔開每個檔案,避免前檔結尾吃掉後檔開頭
},
dist: {
src: ['js/*.js', 'js/**/*.js'], // 要合併的來源
dest: 'js/fishchart_v0.0.1.js' // 輸出的檔案
}
},
// 壓縮設定
uglify: {
js: {
files: {
'js/fishchart_v0.0.1.js': ['js/fishchart_v0.0.1.js'] // 壓完覆蓋回合併後的檔案
}
}
}
});
// 載入要用到的 task
grunt.loadNpmTasks('grunt-contrib-jshint');
grunt.loadNpmTasks('grunt-contrib-concat');
grunt.loadNpmTasks('grunt-contrib-uglify');
// 定義 task 組合
grunt.registerTask('development', ['jshint']);
grunt.registerTask('production', ['jshint', 'concat', 'uglify']);
}
最後那兩行是整個設定的精華:你把「檢查、合併、壓縮」三個步驟綁成一個叫 production 的 task。之後只要執行 grunt production,三件事會照順序跑完。開發中則跑 grunt development 只做語法檢查,速度快得多。

跑完之後,js/ 底下多了一份 fishchart_v0.0.1.js,內容是原本所有檔案按順序拼接、再去掉空白與註解後的精簡版本。發布時只要引入這一個檔案。
separator 那個分號不是裝飾。如果前一個檔案結尾沒有分號,而後一個檔案開頭是 (function(){...})() 這種形式,合併後會被解析成「呼叫前一個運算式的結果」,直接炸掉。加上 separator 是最基本的保險。
合併順序很重要。有相依關係的檔案必須照順序排,*.js 這種通配通常不是你想要的最終順序,正式專案會明確列出檔案清單。
壓縮前先做 source map。uglify 可以產生 source map 檔,讓你在瀏覽器開發者工具裡debug時看到的仍是原始碼而不是壓縮後的迷霧。少了它,線上出錯時的除錯體驗會非常痛苦。
別壓縮要公開的第三方庫。很多庫官方已經提供 .min.js,自己再壓一次收益極小,還可能壓壞。
最後要說的是時代背景:Grunt 在 2013 年前後幾乎是前端建置的標準答案,但今天主流已經換成 Vite、webpack、Rollup 這類打包工具,Grunt 主要還存在於維護中的老專案。觀念是相通的——「把開發用的多檔源碼,轉成正式環境用的單一精簡檔案」,只是工具換了形狀。