1.3 老镜像站与新官网：两个文档站怎么用

两个站，两种定位

查 layui 文档时，你大概率会撞见两个网站：一个是 layui.wanxiangsucai.com，一个是 layui.dev。两站版式迥异、内容各有侧重。简单说：老镜像站是 2.6.x 时代官方文档的镜像查阅库，新官网则是现行 2.x 官方文档的大本营。分不清这两者，是新手查文档最容易迷路的地方。

老镜像站：2.6.x 时代的查阅库

老镜像站 layui.wanxiangsucai.com 保留着经典官方文档版式，对应 2.6.x 时代的官方文档。站内提供 layui-v2.6.8 的下载，目录结构沿用老式的 /doc/ 与 /demo/。它的价值在于：维护 2.6.x 老项目时，组件参数与示例代码都能在这里查到与版本匹配的说明。对这类项目来说，它就是一座时间被冻结的查阅库。使用它时的心态也要摆正：这是为老项目服务的查阅库，而不是新开发的起点——2.6.x 之后框架发生的一切变化，它都不会告诉你。

新官网：现行文档的大本营

新官网 layui.dev 是现行 2.x 官方文档所在地，文档路径为 /docs/2/。它的能力比老镜像站丰富得多：

• 版本切换：页面顶部可在 2.13.9 与 2.7.6 两个版本文档之间切换，兼顾新特性查阅与过渡期项目。
• 更新日志（versions）：逐版记录变更，升级前必看。
• 在线测试（playground）：不搭环境就能验证组件行为。
• 笔记（notes）：包含 2.8 以来的升级指南与浏览器兼容说明。
• 生态页：收录第三方扩展、纯静态主题库与社区深色主题。
• 静态资源：走 res.layui.dev 的 CDN，引文件更省心。

这几个入口我各有心得。版本切换器解决的是过渡期项目的查阅问题——页面顶部默认是 2.13.9 文档，也可切回 2.7.6，项目升到一半、拿不准该看哪版说明时，切一下就对齐了。playground 适合验证组件行为，参数拿不准时比翻文档更快。notes 里的升级指南与浏览器兼容说明，是任何升级动作之前必读的功课，别嫌麻烦直接开写。

两个文档站对比

各自的正确用法

两个站怎么用，一张表说清：

一句话概括：老项目查老镜像站，新开发盯新官网。维护 2.6.x 项目时，老镜像站的版本匹配度最高；做新功能、看新特性、查升级指南，一律以新官网为准。

一个最常见的坑

最后提醒一个高频踩坑点：搜索引擎经常把老镜像站排在结果前面。你搜某个组件的用法，点进去很可能是 2.6.x 时代的文档，而你手上的项目用的却是 2.13.x——参数对不上、行为不一致，排查半天发现是文档版本错了。我的习惯是两条：第一，从搜索引擎点进 layui 相关页面后，第一件事先核对页面上的版本号；第二，查新版本用法时直接去 layui.dev 站内查，别依赖搜索引擎的排序。文档查错版本，是 layui 相关问题里最冤枉的一类错误。