准备工作

开发环境

使用本模板前，需要在本地依次安装好 Node.js, pnpm, Git(非必须) 和 Visual Studio Code。

兼容性注意

目前项目内对环境的校验为强检验，不符合要求的环境将无法启动项目。
Node.js 需要使用 >=18.12.x <=19.0.0 或 >=20.9 版本，推荐 18.18.0
pnpm 需要 >=8.15.5 版本
当你的包管理器发出警告时，请注意升级你的 Node 版本。

Node安装

如果您电脑未安装Node.js，请安装它。

验证

bash

# 出现相应npm版本即可
npm -v
# 出现相应node版本即可
node -v

如果你需要同时存在多个 node 版本，可以使用 Nvm 或者其他工具进行 Node.js 进行版本管理。

pnpm安装

必须使用 pnpm进行依赖安装（若其他包管理器安装不了需要自行处理）。

如果未安装pnpm，可以用下面命令来进行全局安装

bash

# 全局安装pnpm
npm install -g pnpm
# 验证
pnpm -v # 出现对应版本号即代表安装成功

Virtual Studio Code

然后在 Visual Studio Code 里安装好以下扩展：

提示

在 Visual Studio Code 里打开源码文件夹，右下角会自动提示需要安装的依赖，直接点击安装即可。

EditorConfig for VS Code 帮助开发者在不同的编辑器维护一致的编码风格。
DotENV 支持.env文件的语法高亮和其他特性。
ESLint 在VS Code中集成ESLint，用于JavaScript和其他语言的代码质量和风格检查。
stylelint 支持CSS、SCSS等样式文件的质量和风格检查。
UnoCSS 集成UnoCSS，一个原子CSS引擎，用于快速构建样式。
Tailwind css 为Tailwind css提供自动完成和其他智能感知功能。
Error Lens 通过在编辑器中直接高亮显示，增强错误和警告的可见性。
Error Gutters 在VS Code的装订线(gutter)中显示错误和警告图标。
i18n-ally 全功能的i18n工具，支持多种语言的项目国际化。
Vue - Official 官方Vue3支持扩展，为Vue文件提供语法高亮、类型检查等功能。

🎉 额外推荐

以上为开发时必备扩展，以下则是作者推荐安装的扩展，安装它们将在一定程度上提升开发效率。

GitLens 图形化Git工具，提供了丰富的Git功能。
File Nesting 支持自定义文件嵌套规则，以便在项目浏览器中更有组织地显示文件。
Iconify IntelliSense 可视化显示Iconify图标，提供智能感知和代码片段。

技术栈

了解并熟悉框架使用到的技术栈，能让你使用本框架更得心应手。

浏览器支持

本地开发 推荐使用最新版的 Chrome 浏览器，不支持Chrome 80以下版本。

生产环境 支持现代浏览器，不支持 IE。

IE	Edge	Firefox	Chrome	Safari
not support	last 2 versions	last 2 versions	last 2 versions	last 2 versions