Vue3+Vite项目搭建

技术栈：vue3+ts+vite+vue-router+element-plus+pinia

1、vite创建vue3+ts项目：

为什么选择vite而不是vue-cli：
vite 是一个基于 Vue3 单文件组件的非打包开发服务器，它做到了本地快速开发启动：

快速的冷启动，不需要等待打包操作；
即时的热模块更新，替换性能和模块数量的解耦让更新飞起；
真正的按需编译，不再等待整个应用编译完成，这是一个巨大的改变。（平均一秒run）

1.1 初始化

cnpm init vite@latest

1.2 项目信息

• 输入项目名称
• 选择Vue（如果上下键不能选择，就手动输入选项，再回车）
• 选择TypeScript
• 创建完毕

1.3 效果：

1.4 vscode打开，新建终端

（1）初始化

cnpm i

（2）运行

cnpm run dev

（3）效果

1.5 其他配置

（1）依赖

npm i @types/node -D

（2）修改vite.config.ts配置文件代码

import{ defineConfig }from'vite'import vue from'@vitejs/plugin-vue'import{ resolve }from"path"// https://vitejs.dev/config/exportdefaultdefineConfig({plugins:[vue()],resolve:{// ↓路径别名，主要是这部分alias:{"@":resolve(__dirname,"./src")}}})

1.6 报错汇总

（1）插件
使用vscode编写代码的时候，vue3中使用插件时需要禁用以前vue2常使用的插件Vetur，而安装Vue Language Features (Volar)插件。不然代码会提示报错。
（2）报错：找不到模块“xxx”或其相应的类型声明
解决1：没配置依赖

npm i @types/node -D

解决2：
也可能是因为typescript 只能理解 .ts 文件，无法理解 .vue文件。因此需要给.vue文件加上类型说明文件。
在项目根目录或 src 文件夹下创建一个env.d.ts 文件，

并在文件中写入以下内容：

declare module '*.vue'{import type { DefineComponent }from'vue'// eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/ban-typesconstcomponent: DefineComponent<{},{}, any>exportdefault component
}

2、配置路由：

2.1 安装路由

cnpm i vue-router

2.2 在

src

文件夹下创建

views/login/index.vue

<template><div>login页面</div></template><script setup lang="ts"></script><style lang="less" scoped></style>

2.3 在

src

文件夹下创建

router/index.ts

将Home.vue 和 About.vue 全部清空,重新建立vue文件模板(template + script + style)
制作登录页和首页

import{createRouter,createWebHashHistory}from'vue-router'const router=createRouter({history:createWebHashHistory(),routes:[{path:"/login",name:'login',component:()=>import('../views/login/index.vue')}]})exportdefault router

2.4

src/main.ts

中导入挂载路由

import{ createApp }from'vue'import'./style.css'import App from'./App.vue'import router from'./router/index'const app =createApp(App)
app.use(router)
app.mount('#app')

2.5

src/App.vue

中设置路由出口，其他内容都删除

<template><div><router-view></router-view></div></template><script setup lang='ts'>import{ ref }from"vue"</script><style lang="less" scoped></style>

2.6 效果

3、配置ts文件采用@方式导入：

在

tsconfig.json

文件中添加配置

{"compilerOptions":{"target":"ESNext","useDefineForClassFields":true,"module":"ESNext","moduleResolution":"Node","strict":true,"jsx":"preserve","resolveJsonModule":true,"isolatedModules":true,"esModuleInterop":true,"lib":["ESNext","DOM"],"skipLibCheck":true,"noEmit":true,"baseUrl":".","paths":{"@/*":["src/*"]}},"include":["src/**/*.ts","src/**/*.d.ts","src/**/*.tsx","src/**/*.vue"],"references":[{"path":"./tsconfig.node.json"}]}

4、安装代码检测工具

4.1 安装

cnpm install --save-dev eslint eslint-plugin-vue

4.2 在根目录创建.eslintrc.js文件

4.3 复制代码

在rules可以添加自己的验证规则

module.exports ={root:true,parserOptions:{sourceType:"module",},parser:"vue-eslint-parser",extends:["plugin:vue/vue3-essential","plugin:vue/vue3-strongly-recommended","plugin:vue/vue3-recommended",],env:{browser:true,node:true,es6:true,},rules:{"no-console":"off","comma-dangle":[2,"never"],//禁止使用拖尾逗号},};

5、安装css 预处理器 sass:

cnpm install -D sass sass-loader

6、引入element-plus:

6.1 安装

cnpm install element-plus --save

6.2

src/main.ts

中引入

import{ createApp }from"vue";import"./style.css";import App from"./App.vue";import router from"./router/index";import ElementPlus from"element-plus";import"element-plus/dist/index.css";const app =createApp(App);
app.use(router);
app.mount("#app");
app.use(ElementPlus);

6.3 使用

src/views/login.vue

<template><div>login页面</div><el-button type="primary" size="default" icon="el-icon-plus">新增</el-button></template><script setup lang="ts"></script><style lang="scass" scoped></style>

效果：

7、安装pinia:

7.1 安装

npm install pinia

7.2

src/main.ts

中全局引入

import{ createApp }from"vue";import"./style.css";import App from"./App.vue";import router from"./router/index";import ElementPlus from"element-plus";import"element-plus/dist/index.css";import{ createPinia }from"pinia";const pinia =createPinia();const app =createApp(App);
app.use(router);
app.mount("#app");
app.use(ElementPlus);
app.use(pinia);

以上，搭建完成。