vite2.0搭建Vue3移动端项目

用了 Vue3 大半年，项目一直是 vue-cli 基于 webpack 搭的。刚好有个移动端需求，改用 vite 版 Vue3，这里把脚手架、路由、Vuex、Vant3、rem 适配、axios 和代理的过程记下来。

vite + ts + vue3 一行命令就能起项目；Vant 3 内部是 ESM，vite 下不必再配按需加载插件，但样式要全局引入。文末有线上预览和仓库地址。

一、脚手架、路由与技术点

涉及：vite、vue3、ts、路由、vuex、axios、Vant3、移动端适配、请求代理。

vite + ts + vue3 只需要一行：

npm init @vitejs/app my-vue-app --template vue-ts

配置路由

npm install vue-router@4 --save

在 src 下新建 router/index.ts：

import { createRouter, createWebHashHistory, RouteRecordRaw } from "vue-router";
const routes: Array<RouteRecordRaw> = [
  {
    path: "/",
    name: "Home",
    meta: {
      title: "首页",
      keepAlive: true
    },
    component: () => import("../views/Home/index.vue"),
  },
  {
    path: "/login",
    name: "Login",
    meta: {
      title: "登录",
      keepAlive: true
    },
    component: () => import("../views/Login/index.vue"),
  },
];
const router = createRouter({
  history: createWebHashHistory(),
  routes
});
export default router;

在 main.ts 挂载：

import { createApp } from 'vue'
import App from './App.vue'
import router from "./router";createApp(App)
.use(router)
.mount('#app')

二、配置 Vuex 4.x

安装

npm i vuex@next --save

配置

src/store/index.ts：

import { createStore } from "vuex";
export default createStore({
  state: {
    listData:{1:10},
    num:10
  },
  mutations: {
    setData(state,value){
        state.listData=value
    },
    addNum(state){
      state.num=state.num+10
    }
  },
  actions: {
    setData(context,value){
      context.commit('setData',value)
    },
  },
  modules: {}
});

挂载

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')

三、Vant3 与移动端适配

安装 Vant

npm i vant@next -S

vite 版本不需要配置组件按需加载：Vant 3.0 内部模块基于 ESM，天然按需。但样式必须全部引入，约 137.2k。在 main.ts 全局引入：

import { createApp } from 'vue'
import App from './App.vue'
import router from "./router";
import store from "./store";
import 'vant/lib/index.css'; // 全局引入样式
createApp(App)
.use(router)
.use(store)
.use(ant)
.mount('#app')

移动端适配

安装 postcss-pxtorem：

npm install postcss-pxtorem -D

根目录 postcss.config.js，rootValue 与 Vant 官方 37.5 对齐；.norem 开头的 class 不转 rem：

module.exports = {
  "plugins": {
    "postcss-pxtorem": {
      rootValue: 37.5,
      // Vant 官方根字体大小是 37.5
      propList: ['*'],
      selectorBlackList: ['.norem']
      // 过滤掉.norem-开头的class，不进行rem转换
    }
  }
}

src/util/rem.ts（原文路径；main 里按 utils 引入）：

// rem等比适配配置文件
// 基准大小
const baseSize = 37.5
// 注意此值要与 postcss.config.js 文件中的 rootValue保持一致
// 设置 rem 函数
function setRem () {
  // 当前页面宽度相对于 375宽的缩放比例，可根据自己需要修改,一般设计稿都是宽750(图方便可以拿到设计图后改过来)。
  const scale = document.documentElement.clientWidth / 375
  // 设置页面根节点字体大小（“Math.min(scale, 2)” 指最高放大比例为2，可根据实际业务需求调整）
  document.documentElement.style.fontSize = baseSize * Math.min(scale, 2) + 'px'
}
// 初始化
setRem()
// 改变窗口大小时重新设置 rem
window.onresize = function () {
  console.log("我执行了")
  setRem()
}

在 main.ts 引入：

import "./utils/rem"

四、Axios 与请求代理

安装

npm i -s axios

配置 axios

src/utils/request.ts：

import axios from "axios";
const service = axios.create({
  baseURL,
  timeout: 5000 // request timeout
});
// 发起请求之前的拦截器
service.interceptors.request.use(
  config => {
    // 如果有token 就携带tokon
    const token = window.localStorage.getItem("accessToken");
    if (token) {
      config.headers.common.Authorization = token;
    }
    return config;
  },
  error => Promise.reject(error)
);
// 响应拦截器
service.interceptors.response.use(
  response => {
    const res = response.data;

    if (response.status !== 200) {
      return Promise.reject(new Error(res.message || "Error"));
    } else {
      return res;
    }
  },
  error => {
    return Promise.reject(error);
  }
);
export default service;

使用

import request from "../utils/request";
request({url: "/profile ",method: "get"})
.then((res)=>{
  console.log(res)
})

配置请求代理

vite.config.ts：

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import path from 'path';

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [vue()],
  base:"./",//打包路径
  resolve: {
    alias:{
      '@': path.resolve(__dirname, './src')//设置别名
    }
  },
  server: {
    port:4000,//启动端口
    open: true,
    proxy: {
      // 选项写法
      '/api': 'http://123.56.85.24:5000'//代理网址
    },
    cors:true
  }

})

以上，一个最基本的移动端开发配置完成。

五、script setup 与 v-bind

vite 对 script setup 和 CSS 里 v-bind 支持格外友好。

正常写法

<script lang="ts">
import { defineComponent } from "vue";
import { useRouter } from "vue-router";
export default defineComponent({
  setup() {
    const router = useRouter();
    const goLogin = () => {
      router.push("/");
    };
    return { goLogin };
  },
});
</script>

setup 写法

<script lang="ts" setup="props">
import { useRouter } from "vue-router";
const router = useRouter();
const goLogin = () => {
  router.push("/");
};
</script>

是不是简洁了很多。CSS 变量绑定也可以直接 v-bind：

<script lang="ts" setup="props">
const state = reactive({
  color: "#ccc",
});
</script>
<style >
.text {
  color: v-bind("state.color");
}
</style>

就这么简单。

代码与预览

线上预览：http://123.56.85.24/vite/#/

代码地址：github.com/huoqingzhu/vue3-vite-ts-Vant

vitejs 中文网：https://cn.vitejs.dev/

一句话总结：vite 一行拉起 Vue3+TS；移动端再补 vue-router@4、vuex@next、Vant 样式、37.5 rem 和 axios 代理，script setup 能少写一层 defineComponent。