搭建vue3中后台管理模版 (一) - 初始化项目

1,395 阅读2分钟

前言 🐳

自从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

image.png

全局安装 pnpm

  • 使用 pnpm 作为依赖安装工具,让 node_modules 的目录结构友好一点。
npm i -g pnpm

image.png

怎么多了个 pnpx, 看文档已经弃用的,反正用不到,那不管了

image.png

搭建 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

image.png

创建成功,初始目录结构如下

image.png

安装下依赖,看pnpm安装的node_modules有啥不同

# 进入项目根目录
cd vue3-admin-template
# 安装依赖
pnpm i

image.png

可以看到 node_modules 结构精简多了,根级只有package.json安装项,依赖的依赖则被存放在 node_modules/.pnpm

运行项目

pnpm run dev

image.png

image.png

疑问

多了几个不熟悉的文件,先引用大佬们的结论,回头再琢磨

vite-env.d.ts

  • 类型声明文件,在官网文档找到这么一段 image.png

tsconfig.json

  • 项目中 .ts 文件编译配置选项文件
  • 通过 references 字段引入 tsconfig.node.json 中的配置

tsconfig.node.json

  • 专门用于 vite.config.ts 的 TypeScript 配置文件。
  • 使用 references 字段引入的配置文件需要设置 composite: true 字段,并用 include 或 files 等等属性指明配置覆盖的文件范围

参考

共享配置|Vite 官方中文文档 - define

探究 tsconfig.node.json 文件和 references 字段的作用