初始化项目
安装 Vite
首先,确保你的 Node.js 版本 >= 12.0.0。然后在命令行中运行以下命令来创建一个 Vite + Vue 3 + TypeScript 的项目模板:
npm init vite@latest
进入项目目录
创建完成后,进入项目目录:
cd vue3-demo
启动开发服务器
在项目目录中,使用以下命令启动开发服务器:
npm run dev
项目结构
以下是项目的基本目录结构:
├── publish/
└── src/
├── assets/ // 静态资源目录
├── components/ // 公共组件目录
├── hooks/ // hooks函数目录
├── plugins/ // 插件目录
├── router/ // 路由配置目录
├── store/ // 状态管理目录
├── styles/ // 通用 CSS 目录
├── utils/ // 工具函数目录
├── views/ // 页面组件目录
├── App.vue
├── main.ts
├── tests/ // 单元测试目录
├── index.html
├── tsconfig.json // TypeScript 配置文件
├── vite.config.ts // Vite 配置文件
└── package.json
TypeScript 配置
安装 Node 类型定义
如果你需要在项目中使用 Node.js 的类型定义,你可以安装 @types/node
:
npm install @types/node --save-dev
或者在 tsconfig.json
中添加:
"types": [
"node"
]
tsconfig.json
以下是 tsconfig.json
的配置内容:
{
"compilerOptions": {
"target": "esnext",
"module": "esnext",
"moduleResolution": "node",
"esModuleInterop": true,
"strict": true,
"jsx": "preserve",
"experimentalDecorators": true,
"allowSyntheticDefaultImports": true,
"sourceMap": true,
"baseUrl": ".",
"types": [
"node"
],
"paths": {
"@/*": [
"src/*"
]
},
"lib": [
"esnext",
"dom",
"dom.iterable",
"scripthost"
]
},
"include": [
"src/**/*.ts",
"src/**/*.vue"
],
"exclude": [
"node_modules"
]
}
路由配置
安装 Vue Router
安装 Vue Router 4:
npm install vue-router@4
配置路由
创建 src/router/index.ts
并添加以下内容:
import { createRouter, createWebHistory, RouteRecordRaw } from 'vue-router'
import HelloWorld from '../components/HelloWorld.vue'
const routes: Array<RouteRecordRaw> = [
{
path: '/',
name: 'HelloWorld',
component: HelloWorld,
}
]
const router = createRouter({
history: createWebHistory(),
routes
})
export default router
在 main.ts 中使用路由
在 src/main.ts
中添加以下代码来使用路由:
import { createApp } from 'vue'
import './style.css'
import App from './App.vue'
import router from './router'
const app = createApp(App)
app.use(router).mount('#app')
状态管理
安装 Pinia
安装 Pinia 作为状态管理库:
npm install pinia
在 main.ts 中使用 Pinia
在 src/main.ts
中添加以下代码来使用 Pinia:
import { createApp } from 'vue'
import './style.css'
import App from './App.vue'
import router from './router'
import { createPinia } from 'pinia'
const app = createApp(App)
const pinia = createPinia()
app.use(router).use(pinia).mount('#app')
样式预处理器
安装 Sass
安装 Sass 作为 CSS 预处理器:
npm i sass -D
安装 Element Plus
在项目根目录下打开命令行工具,运行以下命令来安装 Element Plus:
npm install element-plus
完整引入
一次性引入 Element Plus 的所有组件和样式,在 main.ts
文件写入:
import { createApp } from 'vue'
import App from './App.vue'
import router from './router'
import { createPinia } from 'pinia'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
const app = createApp(App)
app.use(router)
app.use(createPinia())
app.use(ElementPlus)
app.mount('#app')
一般不推荐这种写法,因为打包后的文件太大,下面介绍官方推荐的方法
按需引入
如果你想要按需引入 Element Plus 的组件和样式,你需要安装额外的插件 unplugin-vue-components
和 unplugin-auto-import
来实现自动导入。
首先,安装这两个插件:
npm install unplugin-vue-components unplugin-auto-import -D
然后,在 vite.config.ts
文件中配置它们:
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import AutoImport from 'unplugin-auto-import/vite'
import Components from 'unplugin-vue-components/vite'
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
export default defineConfig({
plugins: [
vue(),
AutoImport({
resolvers: [ElementPlusResolver()],
}),
Components({
resolvers: [ElementPlusResolver()],
}),
],
})
这样配置后,你就可以在组件中直接使用 Element Plus 的组件,而不需要在每个文件中单独导入。
附:
- 禁用 Vetur 插件,安装 Volar 插件。
- 在ts文件里会出现导入 vue 文件后,提示 找不到模块‘xxx.vue’或其相应的类型声明
解决方式:
在项目根目录新建一个 xx.d.ts
declare module '*.vue' {
import { ComponentOptions } from 'vue'
const componentOptions: ComponentOptions
export default componentOptions
}