解决 TypeScript 引入第三方包，报无法找到模块“XXX”的声明文件错误

最新推荐文章于 2025-04-16 17:48:42 发布

微个日光日

最新推荐文章于 2025-04-16 17:48:42 发布

阅读量6.2w

点赞数 29

CC 4.0 BY-SA版权

分类专栏： web前端 javascript 文章标签： typescript javascript 前端

本文链接：https://blog.csdn.net/xiebaochun/article/details/122458063

web前端同时被 2 个专栏收录

144 篇文章

订阅专栏

javascript

17 篇文章

订阅专栏

本文介绍了解决TypeScript中第三方库类型缺失的问题。提供了两种方法：一是安装对应的TypeScript声明文件；二是手动创建类型声明文件。适合希望提升TypeScript项目开发体验的开发者。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

问题如下：

解决方法

方法一：

根据报错提示尝试安装该库的TypeScript版本（该库的 ts 声明文件），也就是在该库的名称前加上 @types/
本例子为 npm install -D @types/bpmn-moddle
其它库如下：

npm install -D @types/XXX
or
yarn add -D @types/XXX

但是，不是所有的第三方库都有 TypeScript 的版本，所以方法一不能保证百分百有效，如果方法一不奏效，那么我们来看一下方法二。

方法二：

1、在项目根目录新建 types 文件夹。

2、在 tsconfig.json 里的 include 添加上 types

3、在 typings 文件夹里新建类型声明文件，格式为 XXX.d.ts 本例子为 bpmn-moddle.d.ts

4、声明模块类型

declare module 'XXX' {
  const content: any
  /// 这里的 content 可以根据自己的需要，添加需要的类型，这的话可以让 ts 更好的提示
  /**
  type content = {
    test: string
  }
 */
  export = content
}

本例子为：

declare module 'bpmn-moddle' {
  const content: any
  export = content
}

效果如下: