初始化项目
安装 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: ComponentOptionsexport default componentOptions
}