前言
JSHint 是一套 JavaScript 靜態分析工具,它會依你設定的規則檢查程式碼,把可能出錯的地方提前攔下來。除了抓 bug,它還能讓團隊維持一致的 coding style,讓程式碼更可靠、更好讀。本文說明如何安裝、設定與實際使用,並示範幾個常見的檢查結果。
安裝走 npm 即可。若還沒有 npm,先到 Node.js 官網下載安裝 Node.js,npm 會一起裝好。接著執行:
npm install jshint -g
-g 表示全域安裝,如此一來在任何目錄下都能直接呼叫 jshint 指令。
準備一個名為 demo1.js 的檔案:

然後執行:
jshint demo1.js
JSHint 會指出第 8 行少了一個分號。

補上分號再跑一次,輸出就乾淨了。
JSHint 有預設規則,但真正的價值在於高度可調。提供設定有四種方式。
第一,用 --config 指定設定檔:
jshint demo1.js --config config.json
第二,把設定放進 .jshintrc。JSHint 會先在同層目錄尋找,找不到就往上層遞迴到根目錄,因此能為不同專案套用不同規則。
第三,寫進 package.json 的 jshintConfig 屬性下。
這三種方式都用 JSON 描述,每個項目用來開啟或關閉某條規則。例如 "unused" 與 "undef" 會對未使用和未定義的變數發出警告,"curly" 要求迴圈與條件區塊一律加大括號,"eqeqeq" 禁止使用 == 與 != 而應改用 === 和 !==,"globals" 則用來宣告程式碼中未定義但確實存在的全域變數白名單。

第四種方式是把設定以註解形式直接寫在檔案裡,適合單檔除錯時臨時調整。

假設有這麼一段程式碼:

執行 jshint demo2.js --config config.json 後:

四個問題:第 9 行的 if 區塊沒有大括號、宣告了 subscription_id 卻從未使用、以及第 9 行與 11 行的 confirm 和 console 未經定義。
前兩個只要補上大括號並移除無用變數即可解決:

後兩個則是誤判——confirm 與 console 確實是瀏覽器環境提供的。此時在 config.json 加上 "devel": true,JSHint 就會認得它們。

再跑一次,四個錯誤全部消失。
JSHint 是攔 early bug 的好幫手,多數編輯器都有外掛可直接整合,存檔即檢查。建議把設定檔提交進版本庫,讓團隊共用同一套規則;若專案使用較新的語法,也可以考慮 ESLint 這類規則更細緻、外掛生態更活絡的替代方案。有興趣的朋友不妨再往下深入研究。