前言 🐳
自从vue3发布尝鲜后就想用在项目上,无奈我司由于硬性兼容要求,没有机会上vue3。
但新的风暴已经到来,怎么能够停滞不前。
利用平时休息和摸鱼时间,搭建一套即开即用的模板,在这里记录下过程中的点滴(怕不用就忘)
技术栈选择
原本是想用vue2.7做一个过渡模板的,还想着兼容下IE11,但实在精力优先,去特么的IE,不如一步到位好了。
- Vite 用的 3.x, Node.js 要求 14.18+
- Vue 3.x 等完成后再找个比较稳定的版本,毕竟是新东西,先不确定版本,让埋的坑多修复一点
- TypeScript 迟早要上的,避免不了的,但是vscode提示,赛高!!!
环境搭建
本地的node版本需要在 14.18 以上,可以用 nvm 来安装切换node版本
先看下 npm 全局安装了啥
npm ls -g --depth 0
全局安装 pnpm
- 使用 pnpm 作为依赖安装工具,让 node_modules 的目录结构友好一点。
npm i -g pnpm
怎么多了个 pnpx, 看文档已经弃用的,反正用不到,那不管了
搭建 Vite 项目
pnpm create vite
看创建命令,和 vue-cli 有些差异((vue-cli是先全局安装,再创建项目))
实际上执行后,做了这些事情
- 全局安装 create-vite(vite的脚手架)
- 运行 create-vite bin 目录下的一个执行配置
从模板预设创建名为 vue3-admin-template 的项目
pnpm create vite vue3-admin-template --template vue-ts
创建成功,初始目录结构如下
安装下依赖,看pnpm安装的node_modules有啥不同
# 进入项目根目录
cd vue3-admin-template
# 安装依赖
pnpm i
可以看到 node_modules 结构精简多了,根级只有package.json安装项,依赖的依赖则被存放在 node_modules/.pnpm
运行项目
pnpm run dev
疑问
多了几个不熟悉的文件,先引用大佬们的结论,回头再琢磨
vite-env.d.ts
- 类型声明文件,在官网文档找到这么一段
tsconfig.json
- 项目中 .ts 文件编译配置选项文件
- 通过
references
字段引入tsconfig.node.json
中的配置
tsconfig.node.json
- 专门用于
vite.config.ts
的 TypeScript 配置文件。 - 使用
references
字段引入的配置文件需要设置composite: true
字段,并用include
或files
等等属性指明配置覆盖的文件范围