jekip /naive-ui-admin
基于 Vue 3、Vite 7、Naive UI 与 TypeScript 的开源中后台解决方案。内置二次封装组件、动态菜单、路由与按钮级权限、国际化,开箱即用,助力快速搭建企业级中后台。
★ 5,937⑂ 1,063👁 46⑃ 106● 211▤ 22
+0
日增长
5,937
stars
1,063
forks
46
watchers
106
prs
211
issues
22
releases
README
Naive Ui Admin
🚀 简介
Naive Ui Admin 是一款基于 MIT 协议开源、可免费商用的中后台解决方案,基于 Vue 3、Vite、Naive UI 和 TypeScript 构建。
它融合了最新的前端技术栈,提炼了典型的业务模型和页面,包括二次封装组件、动态菜单、权限校验等功能,助力快速搭建企业级中后台项目。项目自 2021 年发布,已持续维护五年。
3.0.0 包含破坏性变更(依赖大版本升级、路由 meta.title 改为 i18n key 等),升级前请先阅读 CHANGELOG。
🌈 特性
📦 二次封装的实用高扩展性组件
🎨 响应式、多主题、多配置,快速集成,开箱即用
🚀 支持前端固定路由 / 后端动态菜单两种路由权限模式,并提供按钮级权限控制
🌍 内置简体中文 / English 国际化,顶栏可实时切换
🌐 持续更新的实用性页面模板和交互设计,简化页面构建
🎥 预览
- naive-ui-admin
账号:admin,密码:123456(随意)
💼 Naive Admin 商业版
商业版与开源版是相互独立的产品线,无代码继承,源码不公开。
| 交付形态 | 档位 | UI 组件库 | 后端 | 在线预览 |
| --- | --- | --- | --- | --- |
| 前端版 | Max | Naive UI | — | max.naiveadmin.com |
| 前端版 | Next | AntdvNext | — | next.naiveadmin.com |
| 全栈版 | Max | Naive UI | PHP / Laravel | max-full.naiveadmin.com |
| 全栈版 | Next | AntdvNext | PHP / Laravel | next-full.naiveadmin.com |
一次买断,全量源码交付,享一年免费更新。价格与活动以官网为准。
商业版官网 · 更新日志 · 常见问题
📚 文档
开源版本文档
🛠 准备
- Node.js 和 Git - 项目开发环境(Node =20.19.0)
- pnpm - 包管理器(=10)
- Vite - 熟悉 Vite 特性
- Vue 3 - 熟悉 Vue 基础语法
- TypeScript - 熟悉TypeScript基本语法
- ES6+ - 熟悉 ES6 基本语法
- Vue Router - 熟悉 Vue Router 基本使用
- Naive UI - UI 基本使用
- @alova/mock / @faker-js/faker - mock 数据与造数
🏗️ 使用
- 获取项目代码
bash
git clone https://github.com/jekip/naive-ui-admin.git
- 安装依赖
bash
cd naive-ui-admin
pnpm install
- 运行
bash
pnpm run dev
- 打包
bash
pnpm build 生产包(默认携带 mock 数据,无需后端即可部署演示)
pnpm build:no-cache 清缓存后重新构建
构建结束后会自动输出体积报告(首屏静态资源,含 gzip / brotli):
bash
pnpm size 只输出体积报告
pnpm report 额外生成 rollup-plugin-visualizer 报告到 .analyze/
首屏体积受 CI 体积预算保护(gzip ≤ 500KB),超限即失败。
默认 VITE_USE_MOCK=true,接口全部走本地 mock,产物约 458KB(gzip)。
接入真实后端时把 .env.production 的 VITE_USE_MOCK 改为 false,
mock 数据与 @faker-js/faker、mockjs 会被完整摇掉,首屏降至约 239KB。
- 类型检查与代码检查
bash
pnpm type-check vue-tsc 类型检查(只读)
pnpm lint:eslint ESLint(flat config,自动修复)
pnpm lint:stylelint Stylelint(自动修复)
两个 lint 脚本都会加 --fix 修改文件;CI 中使用的是不带 --fix 的只读检查(pnpm exec eslint / pnpm exec stylelint)。
🌍 国际化(i18n)
基于 vue-i18n@11,内置 简体中文 / English。顶栏可实时切换,选择会持久化到 localStorage(LOCALE__KEY__),并同步 Naive UI 的 locale / date-locale。
已接入范围:路由菜单、面包屑、多页签、顶栏、项目配置面板、登录页、关于页。业务页面与 src/components 扩展组件保持原样,由使用方按需接入。
路由标题使用 i18n key(如 route.dashboard_console),词条位于 src/locales/lang//route.ts。后端动态菜单同样保留原始 title:返回 key 时跟随切换,返回纯中文标题时因未命中语言包而原样显示。
最小接入示例:
ts
// src/locales/lang/zh-CN/common.ts
export default {
welcome: '欢迎',
};
// src/locales/lang/en-US/common.ts(英文包由 satisfies 约束,漏翻会在 type-check 报错)
export default {
welcome: 'Welcome',
};
vue
import { useI18n } from 'vue-i18n';
const { t } = useI18n();
{{ t('common.welcome') }}
非组件环境(路由生成、菜单转换等)可使用 src/locales/index.ts 导出的 tr()。更多说明见 文档。
📜 更新日志
CHANGELOG
🤝 如何贡献
非常欢迎你的加入!提一个 Issue 或者提交一个 Pull Request
Pull Request:
1. Fork 代码!
2. 创建自己的分支: git checkout -b feat/xxxx
3. 提交你的修改: git commit -am 'feat(function): add xxxxx'
4. 推送您的分支: git push origin feat/xxxx
5. 提交pull request
📋 Git 贡献提交规范
- 参考 Conventional Commits 规范(Angular 约定)
- feat 增加新功能
- fix 修复问题/BUG
- dTop issues
#62v2 Need Discuss19 comments · 2021-10-18#299bug记录15 comments · 2024-10-19#84Consider template version for quick-start?4 comments · 2022-01-12#268编辑表格,表头有时会变白,没找到规律,一般是编辑完 cell,滑动滚动条出现2 comments · 2023-12-12#202English translation2 comments · 2022-12-04#316elementplus版本的源码没有吗1 comments · 2025-06-20#302BasicTable 的pagination 手动设置页码的值为1后并没有回到第一页1 comments · 2024-11-13#288有关闭当前tag的功能吗?1 comments · 2024-06-07
Latest release
3.0.0 v3.0.0 2026-10-21本次为基础设施现代化改造,包含破坏性变更,升级前请阅读下方"破坏性变更"。 🚀 包体优化(首屏 gzip:默认 458KB,关闭 mock 后 239KB,预算 500KB) - mock 可一键摇掉:本项目定位为面向开发者的演示模板,.env.production 默认 VITE_USE_MOCK=true 以保留无后端演示能力;接入真实后端时改为 false,@faker-js/faker + mockjs 等 mock 依赖(约 220KB gzip)会被完整摇掉,首屏 gzip 458KB → 239KB - 删除 naive-ui 全局注册(src/plugins/naive.ts):此前 66 个组件被整包注册,unplugin-vue-components 的按需引入完全失效 - 重写分包策略:manualChunks 由「整库成块」改为只固定框架基座,naive-ui 与业务模块按路由自然分割,避免 1MB 的 naive-ui 块被入口同步引用 - echarts 精简按需注册:只保留 Bar / Line / Pie 与 Grid / Tooltip / Legend / Title,其余图表与组件改为注释可选(817KB → 578KB) - 新增 scripts/report-bundle-size.mjs:统计首屏静态闭包体积(含 g