5.8 KiB
V3 Admin Vite - AI Friendly
English | 中文
简介 
V3 Admin Vite 是一个 AI 友好的后台管理系统模板，基于 Vue3、Vite、TypeScript、Element Plus 等主流技术，并且具备优秀的 Vibe Coding 体验！
支持 Claude Code、CodeX、Cursor、Trae、Antigravity 等主流 AI Coding 工具
通知
Important
欢迎体验全新的 5.2 版本，它将带来不一样的 AI Coding 体验！同时还支持了大家期待已久的后端控制动态路由权限方案~
Warning
4.x 版本如果没有严重的 BUG 将不再维护！点击切换到 4.x 分支
Tip
正式推出付费服务，如果不想自己动手，但想移除 TS 或其他模块？试试懒人套餐！点击看看
Note
如果你有移动端 H5 需求，试试新的开源模板 MobVue
使用
推荐环境
- 新版
Visual Studio Code或者 AI IDECursor与Trae - 安装
.vscode/extensions.json文件中推荐的插件 node20.19+ 或 22.12+pnpm10+
本地开发
# 克隆项目
git clone https://github.com/un-pany/v3-admin-vite.git
# 进入项目目录
cd v3-admin-vite
# 安装依赖
pnpm i
# 启动服务
pnpm dev
打包构建
# 打包构建预发布环境
pnpm build:staging
# 打包构建生产环境
pnpm build
本地预览
# 先执行打包构建命令生成 dist 目录后再执行以下预览命令
pnpm preview
代码检查
# 代码校验与格式化
pnpm lint
# 单元测试
pnpm test
代码提交规范
feat 新功能
fix 修复错误
perf 性能优化
refactor 重构代码
docs 文档和注释
types 类型相关
test 单测相关
ci 持续集成、工作流
revert 撤销更改
chore 琐事（更新依赖、修改配置等）
安装推荐的 Skills
npx skills experimental_install
链接
在线预览：github-pages
中文文档：链接
零基础教程：链接
移动端 H5：mobvue
Electron 桌面版：v3-electron-vite
可有可无的群：查看进群方式
捐赠：请作者喝咖啡
发行版 & 更新日志：releases
特性
结构精简：没有复杂的封装，没有复杂的类型体操，刚好够用
详细的注释：各个配置项都写有尽可能详细的注释
最新的依赖：及时更新所有三方依赖至最新版
有一点规范：代码风格统一、命名风格统一、注释风格统一
内置功能
用户管理：登录、登出演示
权限管理：页面级权限（后端接口控制动态路由）、按钮级权限（权限指令、权限函数）、路由守卫
多环境：开发环境（development）、预发布环境（staging）、生产环境（production）
多主题：普通、黑暗、深蓝, 三种主题模式
多布局：左侧、顶部、混合, 三种布局模式
首页：根据不同用户显示不同的 Dashboard 页面
错误页：403、404
兼容移动端：布局兼容移动端页面分辨率
其他：SVG 雪碧图、动态侧边栏、动态面包屑、标签页快捷导航、内容区放大与全屏、组合式函数
技术栈
Vue3：采用 Vue3 + script setup 最新的 Vue3 组合式 API
Element Plus：Element UI 的 Vue3 版本
Pinia：传说中的 Vuex5
Vite：真的很快
Vue Router：路由路由
TypeScript：JavaScript 语言的超集
pnpm：更快速的，节省磁盘空间的包管理工具
Scss：和 Element Plus 保持一致
CSS 变量：主要控制项目的布局和颜色
ESLint：代码校验与格式化
Axios：发送网络请求（已封装好）
UnoCSS：具有高性能且极具灵活性的即时原子化 CSS 引擎
项目预览图
贡献者
在此感谢所有的贡献者！