從零開始使用 Webpack 搭建 Vue3 開發環境

從零開始使用 Webpack 搭建 Vue3 開發環境

建立項目

首先須要建立一個空目錄，在該目錄打開命令行，執行 npm init 命令建立一個項目，這個過程會提示輸入一些內容，完成後會自動生成一個 package.json 文件

Webpack 的配置文件

project

project-name
+ |- index.html
  |- package.json
+ |- webpack.config.js
+ |- /src
+   |- index.js

webpack.config.js

'use strict'

const path = require('path')
const HtmlWebpackPlugin = require('html-webpack-plugin')
const { VueLoaderPlugin } = require('vue-loader')

module.exports = {
  mode: 'development',
  entry: './src/index.js',
  output: {
    filename: 'index.js',
    path: path.resolve(__dirname, 'dist')
  },
  resolve: {
    alias: {
      'vue': '@vue/runtime-dom',
      'vuex': 'vuex/dist/vuex.esm-bundler',
      '@': path.join(__dirname, 'src')
    }
  },
  module: {
    rules: [
      {
        test: /\.vue$/,
        use: [
          {
            loader: 'vue-loader'
          }
        ]
      },
      {
        test: /\.css$/,
        use: [
          {
            loader: 'style-loader'
          },
          {
            loader: 'css-loader'
          }
        ]
      },
      {
        test: /\.(png|jpe?g|gif)$/i,
        loader: 'file-loader'
        options: {
          name: 'images/[name].[ext]'
        }
      }
    ]
  },
  plugins: [
    new HtmlWebpackPlugin({
      filename: 'index.html',
      template: './index.html'
    }),
    new VueLoaderPlugin()
  ],
  devServer: {
    compress: true,
    port: 8080
  }
}

安裝依賴

npm install --save-dev css-loader file-loader html-webpack-plugin style-loader vue-loader@16.0.0-beta.4 @vue/compiler-sfc webpack webpack-cli webpack-dev-server

• VueLoaderPlugin 的導入方式改變了
• vue-loader@16.0.0-beta.4 當前須要自行指定版本
• vue-template-compiler 沒有了，新增了 @vue/compiler-sfc
• 其它都是 Webpack 基本配置

Vue

npm install --save vue@3.0.0-beta.15 vue-router@4.0.0-alpha.13 vuex@4.0.0-beta.2

當前均須要自行指定版本

根組件

project

project-name
  |- package.json
  |- /src
+   |- app.vue

app.vue

<template>
  <ul>
    <li><router-link to="/">Home</router-link></li>
    <li><router-link to="/about">About</router-link></li>
  </ul>
  <router-view/>
</template>

• 組件根元素容許爲多個

入口文件

src/index.js

import { createApp } from 'vue'

import App from '@/app.vue'
import router from '@/router'
import store from '@/store'

createApp(app)
  .use(router)
  .use(store)
  .mount('#app')

不一樣於 Vue2.0 的整包導入方式，Vue3.0 採用了按需導入的方式，好比這裏只導入了 createApp 這個方法，這樣作的好處是能夠支持 Webpack 的 treeshaking， 其它沒有用到的部分將不會出如今最終打包文件中

Vue3.0 的響應式系統使用了 ES2015 的 Proxy （代理），其瀏覽器兼容性參考 CanIUse，該特性沒法兼容舊瀏覽器

Router

project

project-name
  |- package.json
  |- /src
+   |- /router
+     |- index.js

src/router/index.js

import { createRouter, createWebHashHistory } from 'vue-router'

const routes = [
  {
    path: '/',
    component: require('@/views/index.vue').default
  },
  {
    path: '/about',
    component: require('@/views/about.vue').default
  },
  {
    path: '/:catchAll(.*)',
    component: require('@/views/404.vue').default
  }
]

const router = createRouter({
  history: createWebHashHistory(),
  routes
})

export default router

• 導入方式也爲按需導入
• 原來的 mode 參數變爲 history
• 除了 createWebHashHistory，還有 createWebHistory 和 createMemoryHistory
• 路由未匹配時使用 '/:catchAll(.*)'

在組件中使用 router

import { useRouter } from 'vue-router'

export default {
  setup() {
    const router = useRouter()

    // 也能夠解構
    const { push, go, back } = useRouter()
  }
}

• router 就是原來實例的 $router，也有 beforeEach, afterEach 等等方法

在組件中使用 route

import { useRoute } from 'vue-router'

export default {
  setup() {
    const route = useRoute()
  }
}

• route 是個響應式的代理對象，和原來實例的 $route 同樣，也有 query, params 等屬性
• 不建議將 route 解構，解構後的 query, params 並非響應式的

Store

project

project-name
  |- package.json
  |- /src
+   |- /store
+     |- index.js

該文件建立並導出一個 Vuex 實例

src/store/index.js

import { createStore } from 'vuex'

const store = createStore({
  state: {},
  getters: {},
  mutations: {},
  actions: {}
})

export default store

• 導入方式也爲按需導入
• 其它照舊，沒有什麼變化

在組件中使用 store

import { useStore } from 'vuex'

export default {
  setup() {
    const { state, getters, commit, dispatch } = useStore()

    return {
      state
    }
  }
}

state 是響應式的代理對象，不經過 commit 提交 mutations 而是直接修改 state 也是能夠的，控制檯並無給出什麼警告

NPM Scripts

在 package.json 文件對應的 scripts 處新增命令

package.json

{
  "scripts": {
    "dev": "webpack-dev-server",
    "build": "webpack"
  }
}

更多

• 在 Webpack 項目中配置支持 async/await