通用管理后台项目笔记 - Vue3+Vite安装环境、封装路由-CSDN博客

概述

从0打造通用的后台管理系统系列的第一篇博客开发环境Node+Yarn+Vite的开发环境这是记录的学习笔记。

Node环境

本地使用的是Node v18.18.2npm v9.8.1,安装脚手架工具npm、cnpm、yarn3种方式如果你安装的是旧版本的vue-cli,需要提前卸载npm uninstall vue-cli -g 或 yarn global remove vue-cli,然后从新安装@vue/cli,这里我使用的是yarn。

npm install @vue/cli -g
cnpm install @vue/cli -g
yarn global add @vue/cli

使用vue --version,目前4.x以上版本支持创建Vue3项目,vue-cli官方中文文档https://cli.vuejs.org/zh/guide/

使用vite创建项目

官方文档 https://cn.vitejs.dev

node v18+使用创建项目命令 yarn create vite,在输入项目名称和选项交互的界面非常友好如下图

其他版本的创建项目的命令

npm init @vitejs/app

cnpm init @vitejs/app 

yarn create @vitejs/app manager-fe

创建成功后执行命令

cd stark
yarn
yarn dev

安装项目所需的依赖

# 安装项目生产依赖
yarn add vue-router@next vuex@next element-plus axios -S
# 安装项目开发依赖
yarn add sass -D

在应用市场里VsCode 安装需要的插件:

Eslint
Vetur
TypeScript
Prettier

配置vite中的server配置,官方文档https://cn.vitejs.dev/config/

server:{
host:"localhost",
port:8080
}

可以在项目入口的main.js,打印获取环境变量,如果想更改配置文件在根目录package.json,修改scripts加入--mode dev,更详细的参考官方文档https://cn.vitejs.dev/guide/env-and-mode.html

  "scripts": {
    "dev": "vite --mode dev",
    "build": "vite build",
    "preview": "vite preview"
  },

console.log("环境变量=>",import.meta.env);

至此环境搭建完成了可以开始开发项目代码了。

环境配置

软件项目都会经历本地开发、测试服、生产环境不同的运行环境项目在最开始的时候都会定义config文件对环境进行区分方便切换环境提高工作中的开发效率,也可以在本地部署自己的mock环境我的项目后期会使用PHP作为后端服务实现Api接口。

const env = import.meta.env.MODE || 'prod'
const EnvConfig = {
    dev:{
        baseApi:'/',
        mockApi:''
    },
    test:{
        baseApi:'',
        mockApi:''
    },
    prod:{
        baseApi:'',
        mockApi:''
    }
}
export default {
    env:'dev',
    mock:true,
    ...EnvConfig[env]
}

使用Config 配置的环境,比如可以在封装在axios中的引用

import config from "../config";

//在axios中的引用
const service = axios.create({
    baseURL: config.baseApi,
    timeout: config.timeout
})

路由封装

一个项目最开始的时候都要配置好路由环境路由跳转的三种方式(router-link 、传统跳转 、Composition API跳转)我们分别去分步骤讲解和实现它们

1. main.js 全局加载路由加载路由的过程就相当于引入文件。

import router from './router';
app.use(router).mount('#app')

2.在App.vue的文件需要引入router组件。

<template>
  <router-view></router-view>
</template>

3.使用

router-link 方式

<router-link to="/login">登录</router-link>

传统跳转

<template> 
	<el-button @click="goHome">回首页</el-button> 
</template> 
<script> 
	export default { 
		name:'login', 
		methods:{ 
			goHome(){ 
				this.$router.push('/welcome') 
				} 
			} 
	}
</script>

Composition API跳转:

<script setup> 
import { useRouter } from 'vue-router' 
let router = useRouter() 
const goHome = ()=>{ 
    router.push('/welcome') 
}
</script>

封装axios

封装axios更能提高效率对Http 请求(request)、响应(response)进行token验证和返回参数拦截。

import axios from "axios";

//创建axios实例对象添加全局配置
const service = axios.create({
    baseURL: config.baseApi,
    timeout: 8000
})

//请求拦截
service.interceptors.request.use((req) => {
    //请求拦截具体逻辑代码实现
    return req;
})

//响应拦截
service.interceptors.response.use((res) => {
    //响应拦截具体逻辑代码实现
})

function request(options){
    options.method = options.method || 'get'
    if(options.method.toLowerCase() === 'get'){
        options.params = options.data;
    }

    if(config.env === 'prod'){
        service.defaults.baseURL = config.baseApi
    } else {
        service.defaults.baseURL = config.mock ? config.mockApi : config.baseApi
    }
    return service(options)
}

['get','post','put','delete','patch'].forEach((item) => {
    request[item] = (url,data,options) => {
        return request({
            url,
            data,
            method:item,
            ...options
        })
    }
})

export default request;

在控制器中的使用的时候 在main.js中全局导入组件使用

app.config.globalProperties.$request = request;

this.$request({
  method: 'get',
  url: 'http://192.168.88.140/test.php',
}).then((res) => {
  console.log(res)
})