如何正确配置oddslib JS库及解决导入时声明文件缺失警告

DevOps 小满

2026-10-4

安装状态说明

你已经正确完成了oddslib库的安装，该警告和库本体的安装无关，是TypeScript类型声明缺失导致的提示：oddslib本身未内置TypeScript类型定义文件，官方也没有发布第三方维护的@types/oddslib类型包，因此TS编辑器无法识别该模块的类型，默认将其标记为any类型抛出警告。

解决方案

下面提供4种可落地的解决方式，你可以根据自己的项目需求选择：

方案1：尝试安装官方推荐的类型包
执行命令npm i --save-dev @types/oddslib，如果当前npm源中存在该类型包即可直接解决问题。目前该包暂未发布，大概率会安装失败，可直接选用后面的方案。
方案2：临时忽略单条导入的类型检查
在导入语句的上一行添加注释// @ts-ignore，即可跳过当前导入语句的类型校验，适合临时测试场景使用，缺点是后续调用oddslib相关方法时不会有类型提示。
方案3：手动添加全局模块声明
1. 在项目根目录或者src目录下新建declarations.d.ts类型声明文件，写入以下内容：
```
declare module 'oddslib' {
  const oddslib: any;
  export = oddslib;
}
```
1. 打开项目根目录的tsconfig.json文件，确认include字段包含了声明文件所在的路径，例如声明文件放在根目录时，需要配置：
```
{
  "include": ["./**/*", "./*.d.ts"]
}
```
配置完成后重启编辑器即可消除警告，后续你可以自行补充oddslib相关方法的类型定义，获得完整的代码提示。
方案4：改用CommonJS方式导入
将ESModule导入语句替换为const oddslib = require('oddslib');，多数TS默认配置下不会触发该类型警告，缺点同样是无类型提示。