目录
一、创建vite项目
二、启动vite项目
三、处理一些配置问题
四、增加工程化插件
1、安装sass
2、安装vue-router
3、安装pinia
4、安装element-plus
5、安装axios
6、设置路径别名,将相对路径改为绝对路径
一、创建vite项目
1、在一个文件夹下通过cmd打开,输入命令
 npm create vite@latest 
2、接着选择ts

3、创建好之后,结构目录如下:

二、启动vite项目
1、启动项目前需要先 npm i ,从上图可以发现 vite 不会自动帮助我们install相关的依赖,需要我们手动去安装
npm i2、此时再通过npm run dev就启动好了

 
 
三、处理一些配置问题
1、当我们打开一个引入vue的页面,会发现如下报错,如何解决?

翻译过来是找不到 vue模块 需要将 moduleResolution设置成node
解决方式:
找到 tsconfig.json 文件, 将 moduleResolution设置成 node,报红就没了

2、在main.ts中可能也会报如下错,虽然不影响项目运行,但看着难受

解决方式:
找到 vite-env.d.ts 文件,在里面追加如下代码,保存即可:
declare module "*.vue" {
  import type { DefineComponent } from "vue";
  const vueComponent: DefineComponent<{}, {}, any>;
  export default vueComponent;
}

3、在写ts语法的时候,一些变量名未使用也会报错,想消除怎么办?

解决方式:
在 tsconfig.json 中将noUnusedLocals改为false,不去校验未使用的变量。

这样就不会报错了

四、增加工程化插件
1、安装sass
这是因为 sass 模块是使用 scss 文件必备的工具,所以我们需要安装 sass,
注意:增加 -D 参数,在开发环境中才使用 sass,因为生产环境,scss 文件会被编译成 css 文件,这个插件是用不到的
npm install sass -D此时我们就可以创建一个common.scss文件,然后在main.ts中引入即可

2、安装路由
npm i vue-router
成功之后,我们来使用一下:
(1)在src下创建pages文件夹,存放路由页面
在pages下面创建一个login页面,点击登录进入index页面

<template>
      <div @click="tologin">登录</div>
</template>
<script lang="ts" setup>
import { useRoute, useRouter } from 'vue-router'
const router = useRouter()
function tologin() {
      router.push({
            name: 'index'
      })
}
</script>(2)写好页面之后,我们来创建路由,在 src 路径下新建 router/index.ts
index.ts
import { createRouter, createWebHistory, } from 'vue-router'
export const routes = [
      {
            path: '/',
            redirect: '/login',
      },
      {
            name: 'login',
            path: '/login',
            component: () => import("../pages/login.vue")
      },
      {
            name: 'index',
            path: '/index',
            component: () => import("../pages/index.vue")
      }
]
const router = createRouter({
      scrollBehavior: () => ({ left: 0, top: 0 }),
      history: createWebHistory(),
      routes,
})
router.beforeEach((to, from, next) => {
      next()
})
export default router(3)在main.ts中引入

(4)在 app.vue 设置 routerview
将app.vue中不必要的东西删除,template只写一个routerview,就可以看到登录页了
 
 
 
 
3、安装pinia
本文大概讲一下,不详细介绍了,详情看文章
vue3【抛弃vuex,使用pinia】_vue3替代vuex_suoh's Blog的博客-CSDN博客
(1)安装pinia
npm i pinia(2)创建文件,在 src 路径下增加 store/index.ts
import { defineStore, acceptHMRUpdate } from "pinia";
export const useStore = defineStore({
      id: "index",
      state: () => ({
            name: "old name",
      }),
      getters: {
            myName: (state) => {
                  return `getters ${state.name}`
            }
      },
      actions: {
            changeName(name: string) {
                  this.name = name
            }
      },
});
if (import.meta.hot) {
      import.meta.hot.accept(acceptHMRUpdate(useStore, import.meta.hot))
} 注意:这里有个import.meta.hot判断作用如下:
Pinia 是 vuex 新替代方案。Pinia 中热更新实现,借助 import.meta
热更新:(Hot Module Replacement,简写 HMR)代码会自动更新页面。当修改代码时,HMR 能够在不刷新页面的情况下,把页面中发生变化的模块,替换成新的模块,同时不影响其他模块的正常运作。
Pinia 支持热更新,所以你可以编辑你的 store,并直接在你的应用中与它们互动,而不需要重新加载页面,允许你保持当前的state、并添加甚至删除state、actions和getters。
目前,只有Vite被官方支持,不过任何实现import.meta.hot规范的构建工具都应该能正常工作。你只需要在任何 store 声明旁边添加这段代码。比方说,你有三个 store:auth.js、cart.js和chat.js,你必须在每个 store 声明后都添加(和调整)这段代码即可。即:
if (import.meta.hot) {
      import.meta.hot.accept(acceptHMRUpdate(useStore, import.meta.hot))
}(3)在main.ts中引入

(4)在页面中使用

(5)查看效果,点击修改名称

4、安装element-plus
npm install element-plus(1)安装完成之后,在main.ts中引入
import { createPinia } from 'pinia'
import ElementPlus from 'element-plus'
app.use(ElementPlus)(2)使用
引入一个树形控件
<template>
      <div @click="tologin">登录</div>
      <h2> {{ store.name }}</h2>
      <h1 @click="changeName">修改名称</h1>
      <el-tree :data="data" :props="defaultProps" @node-click="handleNodeClick" />
</template>
<script lang="ts" setup>
import { useRoute, useRouter } from 'vue-router'
import { useStore } from "../store/index";
const router = useRouter()
const store = useStore()
function tologin() {
      router.push({
            name: 'index'
      })
}
function changeName(): void {
      store.name = '索索'
}
interface Tree {
      label: string
      children?: Tree[]
}
const handleNodeClick = (data: Tree) => {
      console.log(data)
}
const data: Tree[] = [
      {
            label: 'Level one 1',
            children: [
                  {
                        label: 'Level two 1-1',
                        children: [
                              {
                                    label: 'Level three 1-1-1',
                              },
                        ],
                  },
            ],
      },
      {
            label: 'Level one 2',
            children: [
                  {
                        label: 'Level two 2-1',
                        children: [
                              {
                                    label: 'Level three 2-1-1',
                              },
                        ],
                  },
                  {
                        label: 'Level two 2-2',
                        children: [
                              {
                                    label: 'Level three 2-2-1',
                              },
                        ],
                  },
            ],
      },
]
const defaultProps = {
      children: 'children',
      label: 'label',
}
</script>(3)看效果

补充:对于下图这个ts的interface不太懂的小盆友,看这里 https://www.cnblogs.com/xuelanying/p/14411850.html
5、安装axios
npm install axios --save(1) 安装好之后,在src下创建utils/request.ts封装axios请求
request.ts
/**axios封装
 * 请求拦截、相应拦截、错误统一处理
 */
import axios from 'axios';
import router from '../router/index'
//  let protocol = window.location.protocol; //协议
//  let host = window.location.host; //主机
//  axios.defaults.baseURL = protocol + "//" + host;
axios.defaults.baseURL = '/api'
axios.interceptors.request.use( //响应拦截
    async config => {
        // 每次发送请求之前判断vuex中是否存在token        
        // 如果存在,则统一在http请求的header都加上token,这样后台根据token判断你的登录情况
        // 即使本地存在token,也有可能token是过期的,所以在响应拦截器中要对返回状态进行判断 
        config.headers.token = sessionStorage.getItem('token')
        return config;
    },
    error => {
        return Promise.reject(error);
    })
// 响应拦截器
axios.interceptors.response.use(
    response => {
        if (response.status === 200) {
            return Promise.resolve(response); //进行中        
        } else {
            return Promise.reject(response); //失败       
        }
    },
    // 服务器状态码不是200的情况    
    error => {
        if (error.response.status) {
            switch (error.response.status) {
                // 401: 未登录                
                // 未登录则跳转登录页面,并携带当前页面的路径                
                // 在登录成功后返回当前页面,这一步需要在登录页操作。                
                case 401:
                    // 自定义过期之后的操作
                    break
                // 403 token过期                
                // 登录过期对用户进行提示                
                // 清除本地token和清空vuex中token对象                
                // 跳转登录页面                
                case 403:
                    sessionStorage.clear()
                    break
                // 404请求不存在                
                case 404:
                    break;
                // 其他错误,直接抛出错误提示                
                default:
            }
            return Promise.reject(error.response);
        }
    }
);
/** 
 * get方法,对应get请求 
 * @param {String} url [请求的url地址] 
 * @param {Object} params [请求时携带的参数] 
 */
const $get = (url: string, params: object) => {
    return new Promise((resolve, reject) => {
        axios.get(url, {
            params: params,
        })
            .then(res => {
                resolve(res.data);
            })
            .catch(err => {
                reject(err.data)
            })
    });
}
/** 
 * post方法,对应post请求 
 * @param {String} url [请求的url地址] 
 * @param {Object} params [请求时携带的参数] 
 */
const $post = (url: string, params: object) => {
    return new Promise((resolve, reject) => {
        axios.post(url, params) //是将对象 序列化成URL的形式,以&进行拼接   
            .then(res => {
                resolve(res.data);
            })
            .catch(err => {
                reject(err.data)
            })
    });
}
// 下面是将get和post方法挂载到vue原型上供全局使用、
// vue2.x中是通 Vue.prototype 来绑定的,像这样Vue.prototype.$toast = Toast。在vue3中取消了Vue.prototype,推荐使用globalProperties来绑定,
export default {
    install: (app: any) => {
        app.config.globalProperties['$get'] = $get;
        app.config.globalProperties['$post'] = $post;
        app.config.globalProperties['$axios'] = axios;
    }
}(2)在main.ts中引入即可
import http from './utils/request.js';
app.use(http)(3)在页面中使用请求,调登录接口
import { getCurrentInstance } from 'vue'
const { proxy } = getCurrentInstance() as any;
function login(): void {
      let data = {
            roleId: "A",
            username: "dpc",
            password: "dpc12345",
            sysType: "zhfw",
      }
      proxy.$post("/index/login", data).then((response: any) => {
            console.log(response)
            router.push({
                  name: 'index'
            })
      })
}
function tologin() {
      login()
}6、设置路径别名,将相对路径改为绝对路径
@types/node 模块 在我们使用 node 方法(比如 path.resolve)时提供 ts 类型声明,否则编辑器会报错,虽然不影响代码运行,但是会有红线很影响心情,如下图所示。

(1)安装 @types/node
npm i @types/node -D(2)在 tsconfig.json 中设置 path
    "paths": {
      "@/*": ["./src/*"]
    }
(3)在vite.config.ts中添加如下配置
import { resolve } from 'path'
export default defineConfig({
  plugins: [vue()],
  resolve: {
    alias: {
      '@': resolve(__dirname, './src')
    },
    //extensions: [".ts", ".js", ".vue", ".json", ".mjs"],
    extensions: [".mjs", ".js", ".ts", ".jsx", ".tsx", ".json", ".vue"],
  },
})
(4)此时就不会报红了
 
 
到这里,一个基本的vue3项目所需要的技术栈插件都配置好了,期待你的一键三连哦~



















