如何在IntelliJ IDEA中使用dukat@next或导入自定义声明至KotlinJS项目

方案一：手动导入自行生成的声明文件 #

• 1. 在KotlinJS项目中创建专门存放声明文件的目录，比如src/main/kotlin-jsMain/declarations
• 2. 将你用dukat@next生成的.kt声明文件复制到这个目录下
• 3. 打开项目的build.gradle.kts（或build.gradle），在kotlin.js配置块中添加声明文件目录的源码路径：

  kotlin {
      js {
          // 保留项目原有配置（如browser、binaries等）
          sourceSets["jsMain"].kotlin.srcDir("src/main/kotlin-jsMain/declarations")
      }
  }
  

• 4. 同步Gradle项目，之后即可直接在代码中引用该NPM模块的external声明
• 注意：确保项目已通过npm install安装目标NPM包，否则声明文件无法关联到实际JS模块

方案二：在IntelliJ IDEA中配置dukat@next自动生成声明文件 #

方法1：通过Gradle指定dukat版本（推荐） #

• 1. 打开项目的build.gradle.kts，在kotlin.js.generateDeclarations块中设置dukat的next版本号：

  kotlin {
      js {
          browser()
          binaries.executable()
          generateDeclarations {
              dukatVersion.set("0.6.0-next.20240520") // 替换为最新的dukat@next版本号
          }
      }
  }
  

• 2. 同步Gradle项目，运行generateKotlinJsDeclarations Gradle任务，即可用指定的dukat@next版本生成声明文件
• 3. IDEA中右键NPM依赖选择「Generate Kotlin/JS Declarations」的自动生成功能，也会使用该版本

方法2：手动指定IDEA中的dukat工具路径 #

• 1. 通过npm安装dukat@next：
  • 全局安装：执行npm install -g dukat@next
  • 项目本地安装：在项目根目录执行npm install dukat@next --save-dev
• 2. 打开IDEA的Settings（macOS为Preferences）→Languages & Frameworks→Kotlin→Kotlin JS
• 3. 在Declaration Generator区域，点击「...」按钮，选择dukat@next的可执行文件路径：
  • 全局安装路径通常为系统全局npm的bin目录下的dukat
  • 本地安装路径为项目根目录node_modules/.bin/dukat（Windows下为dukat.cmd）
• 4. 点击Apply保存配置，之后右键项目中的NPM依赖选择「Generate Kotlin/JS Declarations」，即可用dukat@next生成声明

内容的提问来源于stack exchange，提问作者AmAnVeRmA