开源项目
ColorlibHQ/AdminLTE avatar
ColorlibHQ/AdminLTE

AdminLTE 4:一个没有 jQuery 的 Bootstrap 5 后台模板,值不值得用

AdminLTE - 基于 Bootstrap 5 的免费管理仪表板模板。AdminLTE,Bootstrap 5 管理仪表板 AdminLTE** 是最流行的开源管理仪表板模板,完全响应式,基于 **Bootstrap 5.3** 和普通 JavaScript(无 jQuery)构建,高度可定制且易于使用。

45,599 个 Star18,161 个 ForkAstroMIT

秒懂

它是什么?
AdminLTE 4 是经典的 AdminLTE 基于 Bootstrap 5.3 的重写版本,去掉了 jQuery,改用原生 JavaScript。本文从实际使用角度拆解它的结构、安装方式、定制空间和潜在坑点,帮你判断它是否适合你的下一个后台项目。
适合谁用?
AdminLTE 4 适合那些需要快速搭建一个功能完整、视觉统一的后台界面的团队,尤其是已经熟悉 Bootstrap 的开发者。它提供了大量现成的页面和组件,省去从零写 CSS 和 JS 的时间。
能商用吗?
可以。MIT 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
还在维护吗?
在维护。仓库最近一次提交在 6 天前。
用什么语言写的?
主要是 Astro(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月15日)和我们的分析,不构成法律意见。

开源项目深度解析

一个老牌模板的现代化转身

AdminLTE 在后台模板领域几乎是老牌代名词,但 v4 是一次彻底的重写。它不再依赖 jQuery,而是基于 Bootstrap 5.3 和原生 JavaScript。对于新项目来说,这意味着更少的依赖、更现代的代码风格,也更容易与前端框架集成。但重写也意味着 v3 时代的插件生态不能直接迁移,比如旧的 DataTables 集成方式可能失效,你需要重新寻找 jQuery-free 的替代品。这个版本适合那些想要一个成熟视觉基础、但又不想被旧技术栈绑定的团队。

从 CDN 到 npm:三种安装路径

AdminLTE 4 提供了多种安装方式,最直接的是 CDN 引入,适合快速原型或简单页面。在 HTML 中直接加入两行代码,就能获得完整的样式和脚本。对于更正式的项目,推荐使用 npm 安装:npm install admin-lte@4。安装后,你可以从 dist 目录引入编译好的 CSS 和 JS 文件,也可以按需引入源码进行定制。另外,官方也提供了 Composer 包,方便 PHP 项目使用。无论哪种方式,官方文档都提供了详细的 Getting Started 指南,你还可以直接复制 demo 页面作为起点。

没有 jQuery,组件如何工作

v4 的核心变化是去掉了 jQuery,所有交互组件(如侧边栏、下拉菜单、模态框)都由原生 JavaScript 实现。这意味着你不再需要为了一个后台模板而引入庞大的 jQuery 库,页面加载会更快。同时,组件的 API 也做了相应调整,例如侧边栏搜索插件 SidebarSearch 提供了特定的初始化方法。如果你熟悉 Bootstrap 5 的 JavaScript 插件模式,那么上手 AdminLTE 4 会非常快,因为它的组件很多是建立在 Bootstrap 5 的插件之上的。但要注意,一些自定义组件(如 Ribbons 角标)只是纯 CSS 类,没有对应的 JS 行为,你需要自己处理交互逻辑。

页面组件:从日历到看板,开箱即用

AdminLTE 4 内置了 18 个新的 demo 页面,覆盖了后台常见的应用场景:日历(基于 FullCalendar)、看板(基于 SortableJS)、聊天界面、文件管理器、邮件系统等。这些页面不仅展示了组件的用法,也提供了可复用的 HTML 结构。例如,数据表格页面使用了 Tabulator 库,这是一个无 jQuery 的表格库,适合处理大量数据。对于开发者来说,这些页面是很好的起点,你可以直接复制代码,然后替换成自己的数据。但要注意,这些页面依赖的第三方库(如 FullCalendar、Tabulator)需要额外安装,并非 AdminLTE 自带。

定制主题:CSS 变量与 RTL 支持

定制是后台模板的关键需求。AdminLTE 4 基于 Bootstrap 5.3,因此你可以利用 Bootstrap 的 CSS 变量进行主题定制。官方文档提供了 Customization & Theming 指南,你可以通过覆盖变量来改变颜色、圆角等。此外,v4 支持 RTL(从右到左)布局,对于阿拉伯语等语言环境很有用。不过,定制深度有限,如果你需要完全不同于 Bootstrap 风格的视觉设计,可能需要编写大量覆盖样式。另一个问题是,官方文档虽然提供了语言切换的 recipe,但并未内置多语言支持,你需要自己实现 i18n。

维护与升级:版本迭代频繁,但迁移需谨慎

从仓库的活跃度看,AdminLTE 4 的更新相当频繁,最近一次发布在 2026 年 8 月,说明项目维护是持续的。版本号从 4.8.5 跳到 4.9.0 和 4.9.1,间隔很短,这可能是修复 bug 或小幅改进。对于使用者来说,跟随小版本升级通常成本较低,因为 API 变化不大。但如果你从 v3 升级到 v4,那就是一次重写级别的迁移,因为 HTML 结构、CSS 类名和 JS 插件都变了。官方提供了 CHANGELOG,但升级路径并不自动,你需要手动调整模板。此外,AdminLTE 使用 MIT 许可,你可以自由使用,甚至商用,但需要注意保留版权声明。

替代方案:你其实还有别的选择

如果你觉得 AdminLTE 4 的定制不够灵活,或者你不需要那么多预置页面,可以考虑其他方案。例如,直接使用 Bootstrap 5 的官方示例和组件,自己搭建后台布局,这样你有完全的控制权,但需要更多时间。另一个选择是使用 AdminLTE 的 React 或 Vue 版本,官方提供了 adminlte-react 和 adminlte-vue 仓库,这些版本将组件封装为框架组件,更适合单页应用。但注意,这些版本的 API 和文档可能与 HTML 版本不同,你需要单独评估。如果你只想要一个极简的框架,甚至可以考虑 Tabler 或 CoreUI,但它们的组件生态和社区支持与 AdminLTE 有差异。

编辑结论

AdminLTE 4 适合那些需要快速搭建一个功能完整、视觉统一的后台界面的团队,尤其是已经熟悉 Bootstrap 的开发者。它提供了大量现成的页面和组件,省去从零写 CSS 和 JS 的时间。但如果你需要的是一个高度定制、组件粒度极细的设计系统,或者你的项目深度依赖某个前端框架(如 React 或 Vue),那么直接使用 AdminLTE 的 HTML 版本可能会让你在样式覆盖上花费不少精力。官方也提供了 React、Vue、Angular 等框架的专属版本,但每个版本的成熟度和 API 可能不同,需要单独评估。在决定采用之前,建议先仔细阅读文档中关于自定义主题和 RTL 支持的部分,并实际跑一个 demo 页面,确认它和你现有的构建工具链(如 Vite、Webpack)能顺利集成。最后,检查一下你需要的特定组件(如数据表格、日历)是否在 v4 中已经覆盖,因为 v4 是重写版本,与 v3 的插件生态不兼容,迁移成本可能比预期高。

官方来源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社区笔记

社区笔记