手把手教你搭建vue3.0項目架構

Posted on by

前言：

GitHub上我開源瞭vue-cli、vue-cli3兩個庫，文章末尾會附上GitHub倉庫地址。這次把2.0的重新寫瞭一遍，優化瞭一下。然後按照2.0的功能和代碼，按照vue3.0的語法，完全重寫瞭一遍。雖然名字叫cli，其實兩個庫都是基於vue-cli創建的。做這個的目的是為瞭工作中快速啟動項目，畢竟切片打包、less、axios、vuex、router、UI框架、基礎文件目錄、權限，這些都是基操，當然項目不同，還是要做些調整的。這兩個項目的master分支都是最基礎的東西，裡面還包含瞭幾個自定義的組件。vue-cli3 單獨切出來一個app分支，這個分支會不定時的添加一些功能，比如hightCharts的甘特圖，three.js，用戶可以自定義的大屏展示等等一些功能，現在還啥都沒有，看時間吧，有時間就會更新，會優先寫vue3.0 的，2.0 的再說吧。也希望大傢能幫我完善這個庫，畢竟為瞭快速啟動項目才搭建的，自然越優秀越好。app分支也是希望能有一些好的功能模塊案例，為大傢拓展思路。

一、用 vue-cli 創建項目

npm uninstall vue-cli -g           卸載老版本cli
npm i @vue/cli -g                  安裝新版本cli
npm install -g @vue/cli-init       安裝cli  
vue -V                             查看cli的版本號，註意大小寫
vue create vue-cli                 創建vue3.0項目, 記得選擇vue3

按上述步驟操作即可，我的vue-cli版本號是 4.5.11。這裡註意一下，創建項目的的時候需要手動選擇創建2.0還是3.0的項目，默認是2.0，腳手架是向下兼容的。

二、安裝路由

npm install vue-router@4             安裝路由，4.0版本的

我的路由版本是4.0.12

三、完善目錄結構，創建配置文件vue.config.js

目錄和vue.config.js都貼瞭一下，具體的還是去GitHub直接看源碼，這裡不多占用篇幅瞭。這裡app.less設置瞭顏色變量，統一瞭整個系統的顏色，後期如果做主題，也方便維護。其中antd、vuex等後面再說。

四、安裝ant-design-vue，安裝less、安裝dayjs

npm i --save ant-design-vue@next   安裝 antd3.x的版本  3.0還在不斷更新的階段
npm install babel-plugin-import --save-dev    引入babel， 配置 babel.config 文件，antd組件的按需加載
npm install --save @ant-design/icons-vue  需要的話，引入antd的icon
npm install less --save  引入less
npm i [email protected]   註意版本號
npm i style-resources-loader vue-cli-plugin-style-resources-loader -D  安裝插件，vue.config.js 文件，增加less文件全局配置，主要配置全局變量
npm install dayjs --save 並全局配置下 dayjs， 如果報錯，重裝一下ant-design-vue,dayjs比moment更加輕量

UI框架我用瞭ant-design-vue，這個大傢隨意根據自己需求和喜好來。但是要提醒一下，antd目前2.0版本做瞭對vue3的支持，而且是穩定的，現在正在做3.0版本的升級，項目中用的都是是3.0的寫法，穩定性有待考究。再就是因為antd需要dayjs，這裡也用瞭dayjs，用法大同小異，但是他非常小。項目中用瞭antd的按需加載，不用的組件還是不要引入的好，有需要的在antdUse.js文件引入即可。按需加載的方法官方文檔有詳述，需要修改babel.config.js。antd3的icon變成瞭通過組件的形式引入，使用起來有點繁瑣，也需要註意。

安裝less的babel時，註意版本號，高版本的會報錯。我這裡定義瞭全局的less變量，統一項目的各級別字體大小、各種顏色等等

五、安裝vuex、axios

npm install vuex@next --save   安裝vuex，並配置
npm install axios   安裝 axios，並做統一配置

axios沒有什麼變化。vuex建議詳細看一下官方文檔3.0到4.0的遷移文檔。這裡我簡單列幾個重要的，新版本中，用 createStore創建實例；通過 useStore 獲取當前的vuex實例。具體寫法看代碼。

六、vue3的一些新語法

vue3參考瞭react hooks的實現方式，所以寫法和編程思路很像，這裡非常建議看一下尤雨溪大佬的這篇文章，點我跳轉這裡他對自己升級的前因後果做瞭很詳細闡述，看完會對這次升級有比較清晰的認知。這次更新主要是對組件公共邏輯的提取復用和對單一組件邏輯組織做瞭很大的改動，當然根本動力還是對typescript的支持。ts是大勢所趨。從我個人而言，這次改動很大，使vue3對新手來說，上手難度非常高。對程序員要求也提高瞭很多。很容易出現代碼一鍋粥，邏輯混亂的情況。呃 …還有就是.value 和 props. 的寫法太囉嗦，我是不是要求有點高瞭，手動狗頭，哈哈。

但是，用多瞭之後你會這很好用、很方便。vue3.0數據流向很清晰、還保留瞭數據響應式的老優點。巴適得很啊。博主最開始是用react的，剛開始轉用vue的時候很不習慣，有寫法的原因，最大的還是數據不清晰，所有數據都綁定在this上，可讀性低瞭好多。

。。。扯遠瞭，回歸正題，直接說說按照我的理解，vue3有哪些變化，應該怎麼去用。

首先，vue3支持typescript瞭，鼓掌、撒花。。。建議學習一下，當然用不用都行，毫無影響。隻能說ts作為js的超集，徹底斬斷瞭js的放蕩不羈愛自由，變得中規中矩起來。也讓代碼更加規范，更加可掌控。不過很有意思的是，vue3徹底斬斷瞭vue2的條條框框，徹底釋放自由瞭，變量、方法直接在setup裡面定義，邏輯也都在裡面編寫，再也不需要像以前那樣在規定的地方聲明監聽屬性、聲明方法瞭。這個項目都是用js寫的，我的ts水平也一般，再就是怕大傢看不習慣，畢竟現階段ts的普及還是有點低的。

下面會列舉一些變化，有源代碼，有註釋，直接拉項目跑一下的好，這裡隻是簡單提一些關鍵的變化。

main.js文件。通過 createApp方法創建vue實例，通過app.config.globalProperties.實例原型上添加全局屬性。可創建多實例，也不怕污染。

report.js文件。通過 defineComponent聲明組件，配合 setup這個組合函數完成組件邏輯的開發，具體寫法看源碼report.js這個文件。

setup（props, context）這個組合函數，直接替代瞭vue2.0 computed watch 生命周期 methods等整一套寫法。所有的邏輯，都在這個函數裡面實現。所以，建議統一寫法，雖然以前的寫法也是支持的，個人建議要麼之前那套，要麼一點都不要。不要出現setup和methods同時出現的情況。

  1. setup beforeCreate和created已經不需要瞭，setup的觸發時機其實就是在beforeCreate之前。他僅在實例初始化的時候運行一次，以後再不會執行，setup是同步。
  2. 兩個參數，props是父級組件傳遞的數據，實時更新。不可以解構，會丟失監聽。可以用torefs將props轉為組件內部的監聽數據。但是我個人感覺這不是個好方法，我還是喜歡 props. 的形式使用，這樣代碼一目瞭然，很清楚你用的數據到底是props傳遞的還是當前組件聲明的。數據流向很清晰； context是個對象，可以解構使用，包含emit等屬性，沒什麼好說的，看看文檔就好。
  3. setupthis是沒用的，因為還沒return呢，所以各依賴包為瞭支持這一特性，都做瞭相應的更新 router vuex 都有專門的方法，通過引入的方式獲取到實例。可以看一下下圖的代碼。
  4. 計算屬性、監聽屬性、生命周期。這些都是以方法的形式註入到組件中，生命周期的名字變瞭一些，功能方面並沒有變化，監聽屬性也是，寫法變化瞭。文檔寫的很清楚，這裡，我就不多做贅述瞭。其次還增加瞭一些新的api。ref reactive聲明響應式變量；provide / inject 父子組件互通；watchEffect自動監聽，不太推薦，他會自動監聽所有的響應式變量，任何有變化瞭都會觸發回調，有點類似於update。當然也會導致頻繁執行的問題。一些簡單的頁面可以用，其他情況還是用watch手動標記需要監聽的變量最好。

七、總結

Vue3的新屬性非常多，多研究看文檔。不過目前社區還不是很完善，個人感覺到2022年的年底，應該會改善很多，大部分依賴都會支持。

最後，如果大傢覺得這個項目寫的還可以的，給個star，對代碼有問題，也希望大佬們能修正一下，有好的組件或者效果都可以分享一下。萬一項目有需求就用上瞭呢，哈哈。

vue-cli地址

vue-cli3地址

到此這篇關於手把手教你搭建vue3.0項目架構的文章就介紹到這瞭。希望對大傢的學習有所幫助，也希望大傢多多支持WalkonNet。

推薦閱讀：