第四篇　升级实战：从 2.6 到 2.13

老房改造：升级的正确心态

如果你的项目还停在 layui 2.6.8 上，心情多半是矛盾的：能用，但不敢动。2.6.8 是 2021 年停更前的末版，此后 layui 沉寂许久，直到 2.8.0 才恢复维护。这几年攒下的与其说是技术债，不如说是心理债——总觉得一动就出事。

其实升级更像老房改造：房子能住，但要动水电。有的墙要刷（替换文件、跑通页面），有的线要重布（迁移 element 写法），有的家具可以趁机换新（用新组件替换旧写法）。心态放平，按步骤来，没有想象中可怕。

四步升级路线图

本篇把升级拆成四步，对应四节内容：

• 评估：摸清使用面、确认浏览器底线、排查破坏性变化，决定升不升、升到哪。
• 替换：锁定 2.13.9，替换文件，先跑通登录页这类最小页面。
• 回归：围绕表格、表单、弹层、日期、上传五大高频区做全页面验证。
• 优化：借新版本能力替换旧写法，把升级红利吃干净。

四节内容怎么读

4.1 教你做升级前评估，附风险评估表；4.2 给出完整实操步骤与报错处理表；4.3 整理 element 迁移的新旧写法映射；4.4 列出升级后的优化机会清单。全篇版本事实以官方升级指南与更新日志为准，你可以按顺序通读，也可以在动手前直接翻 4.1 和 4.2。