layui.config 的 base 必须设为扩展模块的公共根目录（如 /static/layui_exts/），末尾建议加 /，且 config 与 extend 必须在 lay.use() 前执行，仅可调用一次。
layui.config 的 base 路径必须指向模块文件所在目录的父级
配置 layui.config({ base: '...' }) 时，base 不是模块 JS 文件的完整路径，而是所有扩展模块存放的**公共根目录**。比如你的 xmSelect.js 放在 /res/layui/modules/xm-select/xm-select.js，那 base 应设为 '/res/layui/modules/'，而不是 '/res/layui/modules/xm-select/' 或带文件名的路径。
常见错误是把 base 写成具体组件路径，导致 layui.extend() 中的相对路径拼接失败，最终报错 Failed to load module: xmSelect 或直接 404。
-
base值末尾不加斜杠（/）也能工作，但加了更稳妥，避免路径拼接歧义 - 如果模块放在 CDN 或跨域地址，可用
{/}前缀绕过base，例如xmSelect: '{/}https://cdn.example.com/xm-select.js' -
base是全局生效的，整个页面所有layui.use()都受其影响，不要在多个地方重复调用config
extend 映射名和模块 JS 文件路径要严格对应
layui.extend() 的键是模块别名（供 layui.use() 使用），值是相对于 base 的路径（不含 .js 后缀）。比如：
layui.config({
base: '/static/layui_exts/'
}).extend({
regionSelect: 'regionSelect/regionSelect',
xmSelect: 'xm-select/xm-select'
});
这就要求文件真实存在：/static/layui_exts/regionSelect/regionSelect.js 和 /static/layui_exts/xm-select/xm-select.js。少一个层级、大小写不一致、后缀写成 .min.js 都会加载失败。
- Windows 下文件系统不区分大小写，但部署到 Linux 服务器后常因大小写问题 404，务必保持完全一致
- 路径中不能有空格或中文，否则某些浏览器会编码异常，建议全英文 + 连字符
- 如果模块 JS 依赖 CSS，
layui.link()需手动引入，extend不处理样式文件
config 和 extend 必须在 use 之前执行，且只执行一次
layui.config() 和 layui.extend() 必须在任何 layui.use() 调用前完成，否则模块找不到。典型错误写法：
// ❌ 错误：use 在 config 之前
layui.use(['xmSelect'], function(){ ... });
layui.config({ base: '/static/layui_exts/' }).extend({ xmSelect: 'xm-select/xm-select' });
// ✅ 正确：顺序不可逆
layui.config({ base: '/static/layui_exts/' })
.extend({ xmSelect: 'xm-select/xm-select' });
layui.use(['xmSelect'], function(){ var xm = layui.xmSelect; });
- 多个扩展可一次性
extend，不用每个模块都调一次extend() - 如果项目里有多个入口 JS，确保只在一个地方做
config+extend，重复调用会导致后一次覆盖前一次 - 动态修改
base或重extend不会刷新已缓存的模块路径，需刷新页面
模块 JS 文件内部必须用 layui.define() 正确导出
第三方模块 JS 文件本身必须符合 Layui 模块规范，否则即使路径对了也加载失败。核心是两件事：
- 第一行必须是
layui.define(...)，不能是define(...)（AMD）或export default（ESM） - 最后一行必须调用
exports('模块名', ...)，且模块名要和extend中的键、use中的字符串完全一致 - 如果模块依赖
jquery或layer等内置模块，define的第一个参数要显式声明，如layui.define(['jquery', 'layer'], function(exports){...})
比如 xm-select.js 开头应类似：
layui.define(['jquery', 'laydate'], function(exports){
var $ = layui.jquery;
// ... 模块逻辑
exports('xmSelect', {
render: function(options){ ... }
});
});
漏掉 exports 或名字写成 'xmselect'（小写），都会让 layui.xmSelect 为 undefined。
最易被忽略的一点：Layui 2.8+ 默认启用模块缓存，改了 JS 文件内容但没清浏览器缓存或没关 debug: true，会一直加载旧版本。上线前务必检查 Network 面板里请求的实际 URL 和返回内容。
