必须手动编写模块化 layui.d.ts 并按 namespace layui { namespace layer { ... } } 结构声明，配合 layui.use 回调中显式标注参数类型（如 (layer: typeof layui.layer) => {}），才能实现精准类型提示与校验。
layui 本身是纯 JavaScript 写的，没有原生 TypeScript 支持，直接 import 或调用模块时 IDE 不会提示、编译器也不校验——这不是“配不配得上”的问题，而是根本没类型信息。要获得模块化类型约束和编码提示，必须手动补全 layui.d.ts，且关键在于按模块拆分声明、精准绑定 use 加载逻辑。
为什么 declare const layui: any 不行
写成 declare const layui: any 确实能过编译，但等于放弃所有类型能力：layui.layer.open 不提示、layui.form.on 参数无约束、拼错方法名也报不了错。更麻烦的是，Layui 的模块（如 layer、form、table）不是全局挂载的，而是通过 layui.use(['layer'], callback) 异步加载后才可用——any 类型完全掩盖了这个加载时序，导致类型系统无法区分“已加载”和“未加载”状态。
模块类型必须用 namespace 嵌套声明
Layui 的模块设计是扁平命名空间（layui.layer、layui.table），但 TypeScript 要求类型声明与运行时结构一致。不能只写 interface layer { ... }，必须用嵌套 namespace 模拟层级：
declare namespace layui {
namespace layer {
interface OpenOptions {
type?: number;
content?: string | HTMLElement;
yes?: (index: number, layero: HTMLElement) => void;
}
function open(options: OpenOptions): number;
}
interface LayuiStatic {
layer: typeof layer;
table: typeof table; // 后续扩展同理
}
}
这样写才能让 layui.layer.open 触发正确提示。漏掉外层 namespace layui 或内层 namespace layer，VS Code 就识别不了路径链。
use 回调里怎么获得精确类型推导
直接在 layui.use 外部访问 layui.layer 是不安全的——模块可能还没加载。正确做法是在回调参数里显式标注类型，让 TS 知道“此刻这些模块已就绪”：
- 不要写：
layui.use(['layer'], () => { layui.layer.open(...); });—— 这里layui.layer仍是any或未定义 - 要写：
layui.use(['layer'], (layer: typeof layui.layer) => { layer.open(...); });—— 显式把layer参数类型对齐到声明的typeof layui.layer - 多个模块时，用解构 + 类型断言：
layui.use(['layer', 'form'], ({ layer, form }: { layer: typeof layui.layer; form: typeof layui.form }) => { ... });
这是最容易被跳过的一步：不标注回调参数类型，TS 就无法把“模块已加载”这个运行时事实映射到类型系统，编码提示和参数校验全部失效。
类型文件必须放在 src 下且被 tsconfig.json 包含
很多开发者把 layui.d.ts 放在项目根目录或 node_modules 里，结果 TS 编译器压根不读取。必须确保：
-
layui.d.ts在src/目录下（或types/子目录） -
tsconfig.json的include字段包含该路径，例如："include": ["src/**/*", "src/types/*.d.ts"] - 不能依赖
types字段自动发现——Layui 不是 npm 包，没有package.json#types入口
另外，layui.d.ts 文件顶部**不能加 export**，否则会被当成模块脚本，导致全局 layui 变量不可见；它必须是纯粹的全局声明文件。
真正卡住人的从来不是写多少类型定义，而是搞清“模块加载时机”和“类型作用域”的对应关系——Layui 的异步模块机制和 TS 的静态分析天然有张力，绕开这点谈类型提示，全是空中楼阁。
