故事是這樣開始的。那天我用 webpack-sample 起了一個 vue-cli 專案,順手在 app.vue 裡寫了個 ready 鉤子,結果裡面的邏輯怎麼都不跑。webpack 配置翻了一遍,package.json 也對了一遍,一切看起來都很正常;開啟 DevTools,控制台乾乾淨淨,連一條警告都沒有。這種「啥都沒錯但就是不work」的狀態,最讓人抓狂。
最後我跑去 GitHub 翻 webpack-simple 的模板源碼,才恍然大悟:vue init webpack-simple 預設拉下來的已經是 Vue 2.0 了。既然版本對不上,那 ready 不觸發也就說得通了——它在 2.0 裡已經被移除了。
接著我把 2.0 的英文文件從頭到尾掃了一遍,才意識到這一次升級不是「小修小補」,而是動了筋骨。如果你手上還有需要長期維護的專案,貿然升級意味著大量頁面要重寫、不少自訂元件直接報廢。實在沒辦法的話,可以退回 1.0 的模板:
vue init webpack-simple#1.0 my-project
下面挑幾個和日常開發關係最密切的變化來談談,純屬個人理解,僅供參考。完整的對比清單建議直接看官方 issue:https://github.com/vuejs/vue/issues/2873
幾乎每個專案都離不開 ready,而 2.0 直接把它拿掉了,改用 mounted。與此同時還補上了 beforeMount、beforeUpdate、updated 等一整套鉤子。整體思路越來越接近 React 的生命週期模型,粒度更細,控制力也更好。
這幾個實例方法一併被廢棄,官方建議改用 Vuex 做狀態管理,或者自己搭一個全域 event bus。遺憾的是,vux 這類 UI 框架內部大量依賴它們,專案裡凡是用到的地方,在 2.0 下都會失效,甚至直接拋錯。
標記元素或元件時只需要寫 ref,取值一律走 this.$refs:
<p ref="a"></p> // 讀取 this.$refs.a
自訂元件同樣適用這個規則。
過去用來拿 DOM 物件的 $els 不再提供,功能由 $refs 全數接管。
迴圈中的 $index、$key 這兩個內建變數不再可用,需要自己在資料結構裡準備對應欄位,或透過 (item, index) in list 的寫法顯式取得索引。
partial 被移除了。這個功能一直比較冷門,很多人的專案裡壓根沒用過,影響有限。
加上 v-once 之後,元素與元件只會渲染一次,之後的更新直接跳過,適合放靜態內容。
測試或者在根實例上傳 props 時,多了一個 propsData 選項可用。
render 函式的寫法出現了較大調整,過去那套手寫 VNode 的模板需要重新適應。
以上就是 Vue 2.0 中幾個最容易被忽略、卻又實打實會影響遷移成本的變化。升級之前,先把這份清單對照自家專案過一遍,能省下不少事。有任何疑問歡迎留言討論。