Layui离线资源包必须完整本地化:layui.js、layui.css及font目录缺一不可,推荐使用layui.all.js避免动态加载失败,并确保HTML中全部采用相对路径引用,禁用远程请求与自动更新。

确认Layui离线资源包是否完整
没外网时,layui.js 和 layui.css 必须全部本地化,缺一个就可能报 Failed to load module script 或样式错乱。Layui 的模块加载机制依赖相对路径和文件存在性,不支持“按需远程拉取”。
- 从官网或 Gitee 下载完整
dist目录(不是单个 JS 文件),包含css/、font/、layui.js三者缺一不可 - 注意区分
layui.js(模块化)和layui.all.js(全量打包):离线环境推荐用layui.all.js,避免因layui.use动态加载失败导致功能缺失 - 检查
font/目录下的图标字体文件(如iconfont.eot)是否被防火墙或杀毒软件误删——内网服务器常有这类静默拦截
HTML中引入路径必须用相对路径,不能带协议或域名
常见错误是复制 CDN 写法:<script src="https://cdn.staticfile.org/layui/2.12.1/layui.js"></script>,离线时直接 404。所有资源引用必须基于当前 HTML 所在目录做相对定位。
- 正确写法示例(假设
layui.js和layui.css放在同级lib/layui/下):<script src="lib/layui/layui.js"></script> - 如果页面在子目录(如
/admin/index.html),而 layui 在根目录/lib/layui/,就得写成../lib/layui/css/layui.css,不能偷懒用/lib/...绝对路径——某些老旧内网 IIS 或 Nginx 配置下会 403 - 浏览器控制台若报
Cross-Origin Request Blocked,大概率是用了 file:// 协议双击打开 HTML——必须起本地服务(如python3 -m http.server 8000)
模块初始化要避开网络检测逻辑
Layui 自身不联网,但部分第三方扩展(如 laydate 的远程皮肤、upload 的默认上传地址)可能隐含请求。离线部署前必须显式禁用或覆盖这些行为。
本地音视频转录整理技能 — 接收音频、视频、播客链接、字幕、原始转写稿或未整理文字,完成 ASR 转录(本地 faster-whisper / mlx-whisper)、文本清洗整理,输出分享式提纯版中文原文到本地 .txt 文件。所有产物保存在本地。
- 初始化时强制指定
base路径,防止模块内部拼接错误 URL:layui.config({ base: 'lib/layui/modules/' }); - 禁用自动更新检查(虽不常用,但某些定制版会埋点):
layui.cache = { version: '2.12.1', modules: {} }; - 使用
upload模块时,务必传url参数,否则默认值/upload/会触发跨域或 404;离线调试建议先 mock 成javascript:void(0)
内网浏览器兼容性比想象中更脆弱
很多单位内网只允许 IE11 或旧版 Edge(Chromium 内核未升级),而 Layui v2.12.x 已放弃 IE 兼容,容易出现 Object.assign is not a function 或 Promise is not defined。
- 若必须支持 IE11,退回
v2.5.6(最后支持 IE 的稳定版),并手动引入es6-promise和object-assignpolyfill - 检查内网浏览器的“企业模式”或“兼容性视图设置”——它可能强制降级渲染引擎,导致
flex布局崩溃,此时需在加: - 字体图标失效?不是路径问题,而是内网策略禁用了
data:协议(Layui 2.12+ 默认用 base64 内联字体)。回退到font/目录加载方式,或改用 CSS Sprite 替代
离线部署最易被忽略的点:**没人会想到内网浏览器的时区、语言设置或代理配置会影响 JS 模块解析顺序**。比如某银行内网 IE11 把 zh-CN 设为系统语言后,laydate 的中文 locale 文件加载失败——不是网络问题,是模块名匹配逻辑对语言标签大小写敏感。这种细节只能靠现场 console.log(layui.cache) 逐层排查。










