Vite 2.0 搭建 Vue3 移动端项目

Vite 2.0 搭建 Vue3 移动端项目

一. 涉及技术点

  • vite
  • vue3
  • ts
  • router
  • vuex
  • axios
  • vant3
  • 移动端适配
  • 请求代理

二. 步骤

vite+ts+vue3只需要一行命令

npm init @vitejs/app my-vue-app --template vue-ts
复制代码

初始化项目

npm install
npm run dev
复制代码

安装typescript

  1. 在项目的根目录创建文件:tsconfig.json
// 指定了用来编译这个项目的根文件和编译选项
// 配置参考https://www.tslang.cn/docs/handbook/tsconfig-json.html
{
    "compilerOptions": {
        "target": "esnext",
        "module": "esnext",
        "strict": true, //这样可以对`this`上的数据属性进行严格的推断,否则总是被视为any类型
        "jsx": "preserve",
        "moduleResolution": "node"
    },
    "include": [
        "src/**/*", "src/main.d.ts" //**/递归匹配任意子目录
    ],
    "exclude": [
        "node_modules"
    ]
}
复制代码
  1. 修改src/main.js为src/main.ts
  2. 修改根目录下index.html中引入的main.js为main.ts
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <link rel="icon" href="https://juejin.cn/favicon.ico" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Vite App</title>
</head>
<body>
  <div id="app"></div>
  <!--<script type="module" src="https://juejin.cn/src/main.js"></script>-->
  <script type="module" src="https://juejin.cn/src/main.ts"></script>
</body>
复制代码
  1. 修改项目的入口文件为main.ts,在项目根目录创建文件vue.config.js
module.exports = {
    pages: {
        index: {
            entry: 'src/main.ts'
        }
    }
};
复制代码

经过以上步骤之后,会发现项目还是可以正常启动的,但是在main.ts中会发现有一个报错

此时是因为使用ts的时候引入.vue文件的时候会报错,找不到相应的模块,是因为ts只认识以.ts结尾的文件,并不认识.vue结尾的文件,以此要在项目的/src文件下创建一个.d.ts文件来定义一下.vue文件:

// 在没用用到需要具体定义的内容的时候,可以只声明一下'*.vue'就可以
// src/main.d.ts
declare module '*.vue' {
    /* 
    import {ComponentOptions} from 'vue';
    const componentOptions: ComponentOptions;
    export default componentOptions; */
}
复制代码

注意:要给.d.ts文件一个文件名,例如a.d.ts,否则eslint没有办法对其进行格式化;也请不要把入口文件和.d.ts的文件重名,否则.d.ts文件不生效

** 配置路由**

  1. 安装vue-router的时候一定要带上版本号,否则现在安装的还是3.x的版本
npm install vue-router@4
复制代码
  1. 在src/新建文件夹router,并在router文件加下新建index.ts文件:
//现在创建router的方式与vue2.x的版本已经很不同了
import {createRouter, createWebHashHistory} from 'vue-router';
const routes = [
    {
        path: '/',
        redirect: '/home',
    },
    {
        path: '/home',
        component: () => import('../components/home.vue')
    }
];

const router = createRouter({
    history: createWebHashHistory(), //替代之前的mode,是必须的
    routes
});
export default router;
复制代码
  1. 修改src/main.ts:
import {createApp} from 'vue';
import App from './App.vue';
import router from './router/index'; //引入vue-router
import './index.css';

const app = createApp(App);
app.use(router); // 挂载到app上
app.mount('#app');
复制代码

配置状态管理vuex(4.x)

  1. 安装
npm i vuex@next --save
复制代码
  1. 配置

在src下创建store目录,并在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: {}
});
复制代码
  1. 挂载

在main.ts挂载

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

  1. 安装
npm i vant@next -S
复制代码

vite版本不需要配置组件的按需加载,因为Vant 3.0 内部所有模块都是基于 ESM 编写的,天然具备按需引入的能力,但是样式必须全部引入137.2k

  1. 在main.ts全局引入样式
import { createApp } from 'vue'
import App from './App.vue'
import router from "./router";
import store from "./store";
import vant from 'vant'
import 'vant/lib/index.css'; // 全局引入样式
createApp(App)
.use(router)
.use(store)
.use(vant)
.mount('#app')
复制代码

配置网络请求axios

  1. 安装
npm i -s axios
复制代码
  1. 配置axios

在src创建utils文件夹,并在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;
复制代码
  1. 使用
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
  }

})
复制代码

移动端适配(postcss-pxtorem)

  1. 安装postcss-pxtorem
npm install postcss-pxtorem -D
复制代码
  1. 在根目录下创建postcss.config.js
module.exports = {
  "plugins": {
    "postcss-pxtorem": {
      rootValue: 37.5, 
      // Vant 官方根字体大小是 37.5
      propList: ['*'],
      selectorBlackList: ['.norem'] 
      // 过滤掉.norem-开头的class,不进行rem转换
    }
  }
}
复制代码
  1. 在根目录src中新建util目录下新建rem.ts等比适配文件
// 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()
}
复制代码
  1. 在mian.ts引入
import "./utils/rem"
复制代码

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

三. vite对<script setup><style vars>的支持格外友好

正常写法

<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>
复制代码

<script setup>写法

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

是不是简洁了很多

<style vars>如何用?

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

就这么简单!

© 版权声明
THE END
喜欢就支持一下吧
点赞0 分享