1. 项目简介
MaoQi-Admin 是一个基于 Vue3、Vite6、TypeScript 和 UnoCSS 开发的现代中后台管理系统前端解决方案。它旨在提供一个开箱即用、配置灵活、代码规范的高质量后台模板，帮助开发者快速搭建企业级中后台项目。
2. 核心特性
- 最新技术栈：使用 Vue3 的 Setup 语法糖和 Composition API，结合 Vite6 极速构建。
- 类型安全：全面使用 TypeScript 编写，提供更好的类型提示和代码可维护性。
- 极致样式体验：引入 UnoCSS 按需生成原子 CSS，体积小、速度快，搭配自定义 CSS Variables 实现优雅的明暗主题切换。
- 完善的路由与权限：内置基于角色的动态路由与权限拦截机制，支持按钮级别权限颗粒度控制。
- 多组件库兼容架构：底层架构经过精心设计，可无缝对接 Element Plus 或 Naive UI 等主流组件库。
3. 环境准备
在开始之前，请确保您的开发环境满足以下要求：
- Node.js：版本 >= 18.0.0 (推荐使用最新的 LTS 版本)
- pnpm：推荐使用 pnpm 作为包管理器 (版本 >= 8.x)
- Git：版本管理工具
- IDE 推荐：VS Code，并安装
Vue - Official(原 Volar) 插件
4. 快速开始
4.1 获取代码
git clone https://github.com/your-org/maoqi-admin.git
cd maoqi-admin4.2 安装依赖
推荐使用 pnpm 安装依赖以获得更快的速度和更一致的包管理体验：
pnpm install4.3 启动本地开发服务
pnpm run dev运行上述命令后，Vite 将启动一个本地开发服务器。您可以在浏览器中访问终端输出的本地地址（通常是 http://localhost:5173）来预览项目。
4.4 构建生产环境代码
pnpm run build构建完成后，产物将被输出到 dist/ 目录下，您可以将该目录下的文件部署到 Nginx、Nginx 或任何静态资源服务器上。
5. 下一步
现在您已经成功运行了 MaoQi-Admin 项目，您可以继续阅读以下文档来深入了解项目的各项配置与规范：