第一篇　认识 layui 与版本现状

一个被问了无数遍的问题

在国内中后台开发圈子里，围绕 layui 的提问十有八九会落到同一句话上：到底该用老版本还是新版本？有人手上的老项目还跑在 2.6.8 上，不敢动也没精力动；有人准备开新项目，网上一搜教程却发现新旧内容混杂、不知所措；还有人发现两个文档站长得完全不一样，越查越糊涂。这些困惑的背后，是 layui 这几年走过的一段不寻常的路——从 2021 年 10 月前后的宣布停更，到后来恢复维护，再到一路迭代到 2.13.9、进入高频发版期。不把这段来龙去脉讲清楚，选型就无从谈起。

本篇讲什么

第一篇是全书的起点，任务只有一个：把 layui 的现状摆上桌面。我们先看 layui 的定位与生态，弄清它凭什么在国内管理后台与中后台项目里长期占有一席之地；再梳理版本时间线，看清从 2.6.8 停更到 2.13.9 重启活跃这条主线；接着讲老镜像站与新官网两套文档各自的正确用法；最后用一张决策表，正面回答那个高频疑问。

全书三步走

• 第一步：认识现状。搞清 layui 是什么、版本走到了哪里、文档去哪查，这是本篇的内容。
• 第二步：对比差异。逐项对比新老版本在依赖、组件与模块机制上的变化，明白升级到底意味着什么。
• 第三步：落地升级。给出可操作的升级路径与避坑建议，让老项目平稳过渡，让新项目少走弯路。

全书速查表

带着这张速查表，我们出发。