第三方库缺少类型声明时应如何设计最小而准确的环境模块

# 核心结论

第三方库缺少类型声明时，应先确认真实的导出方式、调用签名和运行时行为，再只为项目当前使用的接口编写最小而准确的环境模块。声明文件用于描述既有的 JavaScript 实现，不能凭空创造运行时成员。直接写空的 declare module 虽能临时解除报错，却会使模块近似退化为 any，应仅作为短期过渡方案。

# 底层机制

环境模块使用 declare module "包名" 描述某个模块说明符。声明文件是否包含顶层 import 或 export 会影响其作用域：没有模块标记的文件通常按脚本处理，其中的环境模块可声明新的外部模块；已经是外部模块的文件中，同形语法还可能成为对既有模块