學習Vue3.0,先從搭建環(huán)境開始
Bug源測試,上線來幾個。愿君多修改,今夜眼難合。
這是小編關(guān)于Vue3.0系列文章的第二篇,本文將帶您從零搭建一個基于Vue3.0與vite的Vue3.0開發(fā)環(huán)境,通過本文的學習,你將學習到以下內(nèi)容:
- 使用vite初始化Vue3.0項目
- 配置ts
- 配置vue-router
- 配置vuex
- 使用Vue3.0開發(fā)一個TodoList示例
同時本文的內(nèi)容已錄制為視頻發(fā)布到了B站,可以點擊鏈接跳轉(zhuǎn)到視頻地址,同時您也可以通過微信搜索【前端有的玩】關(guān)注我的公眾號加我微信好友,手摸手和你一起學習Vue3.0
使用vite初始化項目
vite 介紹
vite是尤大大在今年新鼓搗出來的一個工具,尤大大對vite的描述是這樣的: Vite is an opinionated web dev build tool that serves your code via native ES Module imports during dev and bundles it with Rollup for production. 翻譯成中文就是:Vite 是一個由原生 ES Module 驅(qū)動的 Web 開發(fā)構(gòu)建工具。在開發(fā)環(huán)境下基于瀏覽器原生 ES imports 開發(fā),在生產(chǎn)環(huán)境下基于 Rollup 打包。
上面這段話提到了一個關(guān)鍵字ES Module,這個是什么呢?詳細的介紹大家可以訪問 https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Modules 進行查看。此處我們長話短說。在最早的時候,還沒有前端工程化,然后我們寫javascript都是寫到一個文件,然后通過script標簽去引用,后來隨著前端發(fā)展越來越壯大,js之間依賴越來越復雜,這時候就需要有一種可以將JavaScript 程序拆分為可按需導入的單獨模塊的機制來維護這個依賴,隨之就誕生了AMD,CMD等等,而ES Module就是瀏覽器支持的原生模塊依賴的功能。
為什么要用vite
為什么尤大大要推出vite,在我們使用webpack的時候,每次開發(fā)時候啟動項目都需要幾十秒甚至超過一分鐘,比較慢,而且熱更新也比較慢,而vite的主要特點就是快,官網(wǎng)對于vite的特點是這樣描述的
- 快速的冷啟動
- 即時的模塊熱更新
- 真正的按需編譯
到底有多快呢,我們先新建一個項目試試
初始化vite項目
- 初始化項目, 在工作空間打開終端窗口,對于window用戶即cmd,然后執(zhí)行下面命令
- yarn create vite-app my-vue3
執(zhí)行之后就會輸出以下內(nèi)容,可以看到新建項目特別快,僅僅用了1.63s
2. 初始化完項目,通過cd my-vue3進行到項目里面,然后再執(zhí)行yarn安裝依賴(此處建議使用淘寶鏡像,比較快)
3. 依賴安裝完需要通過yarn dev啟動項目
是不是瞬間體驗到了秒啟項目的感覺,啟動之后就可以通過http://localhost:3000來訪問項目了
查看項目結(jié)構(gòu)
使用vscode打開項目之后,可以查看到新建的項目結(jié)構(gòu)與vue-cli4創(chuàng)建的項目結(jié)構(gòu)基本一樣,都是我們很熟悉的App.vue和main.js
查看main.js文件內(nèi)容
打開main.js
- import { createApp } from 'vue'
- import App from './App.vue'
- import './index.css'
- createApp(App).mount('#app')
發(fā)現(xiàn)創(chuàng)建Vue的方式變了,原來是通過new Vue的方法來初始化Vue,在Vue3.0中,修改為了通過createApp的方式,關(guān)于Vue3.0的更多使用方式,我們將在后面的系列文章中逐漸為您帶來講解。
配置typescript
typescript現(xiàn)在已經(jīng)成為了前端必備技能之一,大量的項目也開始基于typescript進行開發(fā)。在使用Vue2.0的時候,因為Vue2.0沒有對typescript進行支持,所以使用ts開發(fā)功能顯示有些別扭。但到了Vue3,其自身源碼便是基于ts開發(fā)的,所以對ts天生有著很好的支持。使用vite配置typescript很簡單,只需要進行以下幾步操作.
- 安裝 typescript
- yarn add typescript -D
2. 初始化tsconfig.json
- # 然后在控制臺執(zhí)行下面命令
npx tsc --init
3. 將main.js修改為main.ts,同時將index.html里面的引用也修改為main.ts, 通過還需要修改App.vue與HelloWorld.vue文件,修改方式如下
- <!--將 <script> 修改為 <script lang="ts">-->
- <script lang="ts">
- import HelloWorld from './components/HelloWorld.vue'
- export default {
- name: 'App',
- components: {
- HelloWorld
- }
- }
- </script>
修改完之后,重啟就可以訪問項目了。雖然這樣配置是可以了,但是打開main.ts會發(fā)現(xiàn)import App from App.vue會報錯: Cannot find module './App.vue' or its corresponding type declarations.,這是因為現(xiàn)在ts還沒有識別vue文件,需要進行下面的配置:
- 在項目根目錄添加shim.d.ts文件
- 添加以下內(nèi)容
- declare module "*.vue" {
- import { Component } from "vue";
- const component: Component;
- export default component;
- }
接下來你就可以開開心心的在組件中使用ts了
配置 vue-router
在Vue2.0中我們路由一般會選擇使用vue-router,在Vue3.0依然可以使用vue-router,不過和Vue3.0一樣當前vue-router的版本也是beta版本,在本文撰寫的時候,版本是4.0.0-beta7
安裝vue-router
因為當前vue-router針對vue3.0的版本還是beta版本,所以不能直接通過yarn add vue-router進行安裝,而是需要帶上版本號
- yarn add vue-router@4.0.0-beta.7
配置vue-router
在項目src目錄下面新建router目錄,然后添加index.ts文件,在文件中添加以下內(nèi)容
- import {createRouter, createWebHashHistory} from 'vue-router'
- // 在 Vue-router新版本中,需要使用createRouter來創(chuàng)建路由
- export default createRouter({
- // 指定路由的模式,此處使用的是hash模式
- history: createWebHashHistory(),
- // 路由地址
- routes: []
- })
與新的Vue3.0初始化方式發(fā)生變化一樣,vue-router的初始化方式也發(fā)生了變化,變成了通過createRouter來初始化路由。
將router引入到main.ts中
修改main.ts文件內(nèi)容如下
- import { createApp } from 'vue'
- import App from './App.vue'
- import './index.css'
- import router from './router/index'
- const app = createApp(App)
- // 通過use 將 路由插件安裝到 app 中
- app.use(router)
- app.mount('#app')
配置 vuex
與vue-router一樣,新的vuex當前也處于beta版本,當前版本是4.0.0-beta.4
安裝vuex
- yarn add vuex@4.0.0-beta.4
配置vuex
在項目src目錄下面新建store目錄,并添加index.ts文件,文件中添加以下內(nèi)容
- import { createStore } from 'vuex'
- interface State {
- userName: string
- }
- export default createStore({
- state(): State {
- return {
- userName: "子君",
- };
- },
- });
引入到main.ts中
- import { createApp } from 'vue'
- import App from './App.vue'
- import './index.css'
- import router from './router/index'
- import store from './store/index'
- const app = createApp(App)
- app.use(router)
- app.use(store)
- app.mount('#app')
開發(fā)TodoList
通過上面的一系列操作,我們的開發(fā)環(huán)境就已經(jīng)配置完成了,接下來我們就通過新的開發(fā)環(huán)境先開發(fā)一個TodoList,來驗證一下是否正常。
添加todolist頁面
- 首先我們先在src目錄下面新建一個views目錄,然后在其中新建文件todo-list.vue,并為文件添加以下內(nèi)容
- <template>
- <div class="todo-list">
- <div>
- <label>新增待辦</label>
- <input v-model="state.todo" @keyup.enter="handleAddTodo">
- </div>
- <div>
- <h3>待辦列表({{todos.length}})</h3>
- <ul>
- <li v-for="item in todos" :key="item.id" @click="handleChangeStatus(item, true)">
- <input type="checkbox">
- <label>{{item.text}}</label>
- </li>
- </ul>
- </div>
- <div><h3>已辦列表({{dones.length}})</h3></div>
- <ul>
- <li v-for="item in dones" :key="item.id" @click="handleChangeStatus(item, false)">
- <input type="checkbox" checked>
- <label>{{item.text}}</label>
- </li>
- </ul>
- </div>
- </template>
- <script lang="ts">
- // 在vue2中 data 在vue3中使用 reactive代替
- import { reactive, computed } from 'vue'
- import { useRouter } from 'vue-router'
- export default {
- // setup相當于vue2.0的 beforeCreate和 created,是vue3新增的一個屬性,所有的操作都在此屬性中完成
- setup(props, context) {
- // 通過reactive 可以初始化一個可響應的數(shù)據(jù),與Vue2.0中的Vue.observer很相似
- const state = reactive({
- todoList: [{
- id: 1,
- done: false,
- text: '吃飯'
- },{
- id: 2,
- done: false,
- text: '睡覺'
- },{
- id: 3,
- done: false,
- text: '打豆豆'
- }],
- todo: ''
- })
- // 使用計算屬性生成待辦列表
- const todos = computed(() => {
- return state.todoList.filter(item => !item.done)
- })
- // 使用計算屬性生成已辦列表
- const dones = computed(() => {
- return state.todoList.filter(item => item.done)
- })
- // 修改待辦狀態(tài)
- const handleChangeStatus = (item ,status) => {
- item.done = status
- }
- // 新增待辦
- const handleAddTodo = () => {
- if(!state.todo) {
- alert('請輸入待辦事項')
- return
- }
- state.todoList.push({
- text: state.todo,
- id: Date.now(),
- done: false
- })
- state.todo = ''
- }
- // 在Vue3.0中,所有的數(shù)據(jù)和方法都通過在setup 中 return 出去,然后在template中使用
- return {
- state,
- todos,
- dones,
- handleChangeStatus,
- handleAddTodo
- }
- }
- }
- </script>
- <style scoped>
- .todo-list{
- text-align: center;
- }
- .todo-list ul li {
- list-style: none;
- }
- </style>
調(diào)整路由
- 首先將App.vue文件內(nèi)容修改為
- <template>
- <router-view></router-view>
- </template>
- <script lang="ts">
- export default {
- name: 'App'
- }
- </script>
2. 然后修改 router/index.ts文件,添加新的路由
- import {createRouter, createWebHashHistory} from 'vue-router'
- // 在 Vue-router新版本中,需要使用createRouter來創(chuàng)建路由
- export default createRouter({
- // 指定路由的模式,此處使用的是hash模式
- history: createWebHashHistory(),
- // 路由地址
- routes: [{
- path: '/todolist',
- // 必須添加.vue后綴
- component: () => import('../views/todo-list.vue')
- }]
- })
這時候我們就可以通過http://localhost:3000/#/todolist來訪問TodoList了,效果如下圖所示
總結(jié)
到此,我們Vue3.0的開發(fā)環(huán)境算是搭建完成了,當然現(xiàn)在還有好多好多要完善的東西,比如我們還需要去調(diào)整一下typescript的配置,然后添加eslint等等。同時如何在組件中跳轉(zhuǎn)路由,使用vuex還沒有去講解,不過至少我們已經(jīng)起步了,更多的內(nèi)容將會在下一篇文章中講到。本文首發(fā)于公眾號【前端有的玩】,歡迎關(guān)注加我好友,我們一起探討Vue3.0