VS2008 安裝好兩個補丁後,引入 jQuery 的 -vsdoc.js 文件就能獲得智慧提示(IntelliSense)。但只要再把 jQuery UI 一起加入,情況就變了:不僅 jQuery UI 沒有提示,原本正常的 jQuery 提示也一起消失。
錯誤訊息如下:
警告 1 更新 JScript IntelliSense 時出錯: jquery-1.9.1-vsdoc.js: 'rootjQuery' 未定義 @ 47:8
推測原因是 jQuery UI 缺少對應的 IntelliSense 註解文件,導致 VS 在解析整組腳本時中斷,連帶讓 jQuery 本身的提示也失效。
在 jQuery UI 的檔案目錄下,手動新增一個空的 JS 檔,命名為 jquery-ui-vsdoc.js,然後把它也加入專案並在腳本引用區中列出。
這樣每個函式庫都有一個對應的 vsdoc 文件,VS 在收集提示資料時就不會因為找不到註解而中斷。
<head> 中用 src 直接引用遠端 CDN 上的 jQuery,VS 是不會去抓的;需要提示時仍得把本機檔案放進專案並用 /// <reference /> 註明。這個問題在較新版本的 Visual Studio 中已大幅改善,但維護老專案時仍可能遇到。