1 项目搭建
1.1 基础
vue版本:Vue3
打包工具:Vite,需要 Node.js 版本 18 或 20
UI:Vant
编程语言:TypeScript
全局状态管理工具:Vuex
CSS预处理语言:Less
开发工具推荐:vscode
vscode推荐拓展:Vue - Official、Vue 3 Snippets 等
1.2 搭建
通过命令行有两种创建方式,可参考 Vite,此处采用 vue-ts 模板。
npm create vite@latest my-vant-vuex-vite-pro -- --template vue-ts
npm init vite@latest my-vant-vuex-vite-pro -- --template vue-ts
到此,一个项目已经初步搭建完成,安装相关依赖 (如果一步步下来的,记得切换到项目根目录再安装)
npm install --registry=https://registry.npmmirror.com
通过命令行已经可以启动项目了
npm run dev
Tips:在不同的项目中对于 node 可能用的版本不一样,可以安装 node管理工具:nvm
此处不再具体讲解。
2 安装依赖
UI组件:vant
npm i vant
按需引入组件所需依赖:unplugin-vue-components、unplugin-auto-import
npm i @vant/auto-import-resolver unplugin-vue-components unplugin-auto-import -D
基于组合API封装好用的工具函数 :@vueuse/core
npm i @vueuse/core
为TypeScript项目提供Node.js的API的类型定义,从而在开发过程中提供代码补全和类型检查的支持:@types/node
npm i @types/node -D
路由管理工具:vue-router
npm i vue-router
CSS预处理语言:Less
npm install -D less
Tips:如遇到安装依赖不成功的可以通过添加淘宝域名的方式安装,不建议使用 cnpm
在安装命令行后边添加:--registry=https://registry.npmmirror.com 如:
npm install vuex@next --registry=https://registry.npmmirror.com
3 项目配置
3.1 配置按需引入
在 vite.config.ts 中,我们引入以下依赖
import AutoImport from 'unplugin-auto-import/vite'
import Components from 'unplugin-vue-components/vite'
import { VantResolver } from '@vant/auto-import-resolver'
在 defineConfig 中 的 plugins 下,配置相关的自动导入
plugins: [
vue(),
AutoImport({
// 自动导入 Vue 相关函数,如:ref, reactive, toRef 等
imports: ['vue', 'vue-router', '@vueuse/core'],
// 自动导入 vant 相关函数 API,如:showToast
resolvers: [VantResolver()],
vueTemplate: true,
// 配置文件生成位置(false:关闭自动生成)
dts: false,
}),
Components({
// 自动导入 vant 组件
resolvers: [VantResolver()]