{"full_name":"jekip/naive-ui-admin","owner":"jekip","name":"naive-ui-admin","shard":"1","url":"https://github.com/jekip/naive-ui-admin","description":"基于 Vue 3、Vite 7、Naive UI 与 TypeScript 的开源中后台解决方案。内置二次封装组件、动态菜单、路由与按钮级权限、国际化，开箱即用，助力快速搭建企业级中后台。","homepage":"https://gratis.naiveadmin.com","topics":["naive-ui-admin","naive-ui-pro","naive-ui","vue3","naive"],"tag_pages":["vue3"],"language":"Vue","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/19426584?u=24986a79737edcd74e4b4064b280206f91287340&v=4","created_at":"2021-07-03T12:02:11Z","pushed_at":"2026-10-21T04:28:51Z","metrics":{"stars":5937,"forks":1063,"watchers":46,"issues":211,"prs":106,"releases":22,"issues_open":30,"issues_closed":181,"prs_open":2,"prs_closed":19,"prs_merged":85,"discussions":0},"growth":{"day":{"stars":0,"forks":1,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[5933,5934,5935,5935,5936,5937,5937],"forks":[1061,1062,1062,1061,1062,1062,1063],"watchers":[null,46,46,46,46,46,46],"issues_open":[null,30,30,30,30,30,30],"prs_open":[null,2,2,2,2,2,2]},"boards":{},"same_owner":[],"issues":[{"number":62,"title":"v2 Need Discuss","comments":19,"created_at":"2021-10-18T03:51:15Z"},{"number":299,"title":"bug记录","comments":15,"created_at":"2024-10-19T16:04:17Z"},{"number":84,"title":"Consider template version for quick-start?","comments":4,"created_at":"2022-01-12T09:38:38Z"},{"number":268,"title":"编辑表格，表头有时会变白，没找到规律，一般是编辑完 cell,滑动滚动条出现","comments":2,"created_at":"2023-12-12T06:35:14Z"},{"number":202,"title":"English translation","comments":2,"created_at":"2022-12-04T21:57:00Z"},{"number":316,"title":"elementplus版本的源码没有吗","comments":1,"created_at":"2025-06-20T03:57:31Z"},{"number":302,"title":"BasicTable 的pagination 手动设置页码的值为1后并没有回到第一页","comments":1,"created_at":"2024-11-13T09:38:42Z"},{"number":288,"title":"有关闭当前tag的功能吗?","comments":1,"created_at":"2024-06-07T08:32:53Z"}],"discussions":[],"latest_release":{"name":"3.0.0","tag":"v3.0.0","published_at":"2026-10-21T04:28:51Z","body":"本次为基础设施现代化改造，包含破坏性变更，升级前请阅读下方\"破坏性变更\"。\r\n\r\n### 🚀 包体优化（首屏 gzip：默认 458KB，关闭 mock 后 239KB，预算 500KB）\r\n\r\n- **mock 可一键摇掉**：本项目定位为面向开发者的演示模板，`.env.production` 默认 `VITE_USE_MOCK=true` 以保留无后端演示能力；接入真实后端时改为 `false`，`@faker-js/faker` + `mockjs` 等 mock 依赖（约 220KB gzip）会被完整摇掉，首屏 gzip 458KB → 239KB\r\n- **删除 naive-ui 全局注册**（`src/plugins/naive.ts`）：此前 66 个组件被整包注册，`unplugin-vue-components` 的按需引入完全失效\r\n- **重写分包策略**：`manualChunks` 由「整库成块」改为只固定框架基座，naive-ui 与业务模块按路由自然分割，避免 1MB 的 naive-ui 块被入口同步引用\r\n- **echarts 精简按需注册**：只保留 Bar / Line / Pie 与 Grid / Tooltip / Legend / Title，其余图表与组件改为注释可选（817KB → 578KB）\r\n- 新增 `scripts/report-bundle-size.mjs`：统计首屏静态闭包体积（含 gzip / brotli），支持 `BUNDLE_BUDGET_KB` 体积预算，`pnpm build` 后自动输出\r\n- 新增 `pnpm size` / `pnpm report`（`rollup-plugin-visualizer` 输出到 `.analyze/`）\r\n- CI 增加体积预算校验：首屏 gzip 超过 500KB 直接失败\r\n\r\n### 🌍 国际化（i18n）\r\n\r\n- 接入 `vue-i18n@11`，内置 `zh-CN` / `en-US`；顶栏新增语言切换入口，选择持久化到 `localStorage`，首次访问按浏览器语言推断\r\n- `naive-ui` 的 `locale` / `date-locale` 跟随当前语言切换（日期选择器、空状态等组件文案同步）\r\n- 路由菜单国际化：`src/router/modules/*.ts` 的 `meta.title` 改为 i18n key（如 `route.dashboard_console`），侧边菜单 / 面包屑 / 多页签统一翻译，切换语言即时生效\r\n- 后端返回的动态菜单若仍是中文标题，未命中语言包时原样回显，不会把 key 暴露给用户\r\n- 语言包拆分到 `src/locales/lang/<locale>`，默认语言（`zh-CN`）随首屏加载，其余语言按需异步加载，不影响首屏体积\r\n- 英文语言包使用 `satisfies typeof zhMessages` 约束，漏翻会在 `pnpm type-check` 阶段直接报错\r\n- 已翻译范围：菜单与框架层（顶栏、多页签、项目配置面板、登录页、关于页）、浏览器标签页标题；页脚组件当前版本未启用；业务页面与 `src/components` 扩展组件保持原样，由使用方按需接入（README「国际化」章节有接入示例）\r\n- 修复菜单不翻译：`NMenuOption` 渲染的是 option 的 `title` 字段而非 `label`，菜单对象由 `...meta` 展开后 `title` 仍是 i18n key，导致侧边菜单始终显示 `route.xxx`；现 `label` 与 `title` 统一赋翻译后的文案\r\n- 修复首次切换语言时侧边菜单不刷新：`setLocale` 先更新 Pinia 状态、后加载语言包，菜单 watcher 会在 i18n 切到新语言前触发；现改为先 `await` 语言包加载与 i18n 切换，再更新响应式状态\r\n- 修复浏览器标签页标题显示 i18n key（`router/guards.ts` 中 `document.title` 现走 `tr()`）\r\n- 后端动态菜单不再在登录时预翻译：`src/router/generator.ts` 保留后端返回的原始 `meta.title`，菜单/面包屑渲染时再翻译，因此 BACK 模式下切换语言也能实时生效；纯中文标题未命中语言包时原样回显\r\n- 项目配置面板的动画类型下拉改为按当前语言显示（`layout.setting.animate.*`）\r\n\r\n### 🎨 登录页重构\r\n\r\n- 重新设计 `src/views/login/index.vue`：由「居中浮空卡片 + 全屏装饰动画」改为「左侧品牌区 / 右侧表单区」的分栏布局\r\n- 移除全部装饰元素与动效：波浪、漂浮几何图形、按钮 ripple、卡片悬浮位移、`animate.css` 入场类（依赖本就未安装，类名无效）\r\n- 主题联动：通过 `useThemeVars()` 把主题色 / 背景色 / 边框色透传为 CSS 变量，登录页自动跟随系统主题色与深色模式\r\n- 表单增强：回车提交、用户名自动聚焦（改用 `NInput` 实例 `focus()`，不再 `querySelector`）、按钮 loading 防重复提交、请求异常兜底提示\r\n- 小屏（< 960px）自动收起品牌区，只保留居中表单卡片\r\n\r\n### ✨ 工程化\r\n\r\n- 新增 `type-check` 脚本（`vue-tsc --noEmit`），项目历史上第一次真正做类型检查\r\n- 新增 GitHub Actions CI（安装依赖 → 类型检查 → ESLint → Stylelint → 构建）\r\n- 新增 `eslint.config.mjs`（ESLint 10 flat config），删除 `.eslintrc.js` / `.eslintignore`\r\n- 新增 `commitlint.config.cjs`、`.cz-config.js`，补装缺失的 `cz-customizable`\r\n- 新增 `.husky` 钩子（`pre-commit` 跑 lint-staged、`commit-msg` 跑 commitlint），并补上 `prepare` 脚本\r\n- 新增 `pnpm-workspace.yaml`，声明 `allowBuilds`（esbuild），解决新版 pnpm 默认拦截构建脚本导致装完跑不起来的问题\r\n- 修复 `build` 脚本依赖了未声明的 `chalk`、`fs-extra`（此前靠依赖提升侥幸可用）\r\n\r\n### ⬆️ 依赖升级\r\n\r\n- `vite` 5.4 → 7.3，`@vitejs/plugin-vue` 3.2 → 6.0，`@vitejs/plugin-vue-jsx` 2.1 → 5.1\r\n- `typescript` 4.9 → 5.9，新增 `vue-tsc` 3.3\r\n- `eslint` 8 → 10、`stylelint` 14 → 17（补 `postcss-html` / `postcss-less`）、`prettier` 2 → 3\r\n- `unplugin-vue-components` 0.22 → 32、`husky` 8 → 9、`lint-staged` 13 → 17、`commitlint` 17 → 21、`rimraf` 3 → 6、`gh-pages` 4 → 6\r\n- `vue` 3.5.21 → 3.5.44、`naive-ui` 2.43 → 2.45、`vue-router` → 4.6、`alova` → 3.5、`@vueuse/core` 9 → 15、`echarts` 5 → 6、`date-fns` 2 → 4\r\n\r\n### 🐛 修复\r\n\r\n- 移除 `vue-types`：`vue-types@4` 会破坏 Vue 3.5 的 props 类型推断，导致 `BasicTable` 可编辑单元格等组件 props 全部塌成 `{}`\r\n- 修复 `BasicUpload` 读取了不存在的 `globSetting.imgUrl`（应为 `fileUrl`），图片地址拼接一直是错的\r\n- 修复生产环境 `.env.production` 仍使用旧变量名 `VITE_GLOB_IMG_URL`（代码读取的是 `VITE_GLOB_FILE_URL`），导致上传/图片前缀为 `undefined`\r\n- 清理 `types/global.d.ts` 中已废弃的 `VITE_GLOB_PROD_MOCK` / `VITE_GLOB_IMG_URL` 声明，补充 `VITE_GLOB_FILE_URL`\r\n- `tsconfig.json` 的 include 指向 `vite.config.mts`，修复配置文件类型检查被跳过\r\n- 登录页、关于页、登录/404 路由标题接入 i18n；关于页版本号与技术栈描述更新为当前实际（Vue 3 / Vite 7 / TypeScript），预览站点链接修正为 `gratis.naiveadmin.com`\r\n- 修复 `CreateDrawer` 未暴露 `openDrawer`，父组件通过 ref 调用在部分场景失效\r\n- 修复 `zoom.less` 中 `transition: o","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}