jekip /naive-ui-admin

基于 Vue 3、Vite 7、Naive UI 与 TypeScript 的开源中后台解决方案。内置二次封装组件、动态菜单、路由与按钮级权限、国际化,开箱即用,助力快速搭建企业级中后台。

★ 5,937⑂ 1,063👁 46⑃ 106● 211▤ 22
VueMITCreated 2021-07-03gratis.naiveadmin.com
下载:3.0.03.0.0 ↓3.0.02026-10-21
+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
  - d

Top issues

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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON