把 jquery-1.7.1.js 放進專案後,檔案上一直掛著一個紅色叉叉。不影響編譯與執行,但看著難受,而且提交到 SVN 時也會跳出提示。上網找了很多方法都沒解決,試了幾輪之後找到一個可行的。
Eclipse 內建了一個 JavaScript 語法驗證器,它會嘗試解析專案裡所有 .js 檔案。而 jQuery 這類大型函式庫通常會用到一些驗證器不認識的寫法——例如與特定瀏覽器的相容 hack、較新的語法、或刻意為效能而寫的非常規結構。驗證器看不懂就標記為錯誤,但實際上程式完全正常。
所以這個紅叉是驗證器的誤判,不是程式碼的問題。把它排除在驗證範圍外,正是對的做法——我們不會去修改 jQuery 的原始碼來遷就 IDE。
1. 排除整個函式庫,而不是單一檔案。 若日後換版本或加入 jQuery UI、外掛等,每個都要重設一次很麻煩。可以在規則裡用「資料夾」層級排除,例如把整個 js/vendor/ 排除掉。
2. 紅叉殘留時,先清理專案。 設定完成後若叉叉還在,試試 Project → Clean,或刪除 .metadata/.plugins/org.eclipse.core.resources/.markers 相關快取後重新 import。
3. 也可以關掉驗證器。 在 Window → Preferences → Validation 把 JavaScript Validator 的勾選取消,或在 Manual/Build 頁籤調整觸發時機。若你的專案本來就不在 Eclipse 裡寫前端,直接關掉更省事。
4. 更根本的做法:用正規的前端工具鏈。 在 IDE 的語法檢查器裡跟 jQuery 原始碼纏鬥,本身就反應出一個問題——第三方函式庫不該被當成自己的程式碼來檢查。若改用 ESLint 這類工具,只要設定一行就能排除:
// .eslintignore js/vendor/ node_modules/
並搭配 env: { jquery: true } 讓 ESLint 認識 $ 等全域變數。這樣的設定隨專案走、能進版控,也不會因為換一台電腦就得重設一次。
最後,若專案仍在用 SVN 且 Eclipse 版本較舊,值得評估是否該升級工具鏈——新版的 Eclipse 與各編輯器對現代 JavaScript 的支持都比這要好得多。