借助Gradle在IntelliJ IDEA中配置Node.js模块依赖Kotlin/JS打包文件

1. 固定模块A的打包输出路径 #

首先在模块A的build.gradle.kts（Groovy版则用build.gradle）中，配置webpack打包的输出目录，将产物放到项目内的共享位置，方便模块B访问：

kotlin {
    js {
        browser {
            webpackTask {
                // 生产环境打包输出到项目根目录的shared/dist/production
                outputDirectory.set(file("$rootDir/shared/dist/production"))
            }
            developmentWebpackTask {
                // 开发环境打包输出到项目根目录的shared/dist/development
                outputDirectory.set(file("$rootDir/shared/dist/development"))
            }
        }
        binaries.executable()
    }
}

2. 模块B中引用模块A的打包文件 #

模块B作为Node.js模块，有两种常用引用方式：

直接文件路径引用 #

在模块B的代码中，通过相对路径直接引入打包后的文件：

// 生产环境
import moduleA from '../../shared/dist/production/main.js';

// 开发环境
import moduleA from '../../shared/dist/development/main.js';

如果模块B使用CommonJS规范，改用require：

const moduleA = require('../../shared/dist/production/main.js');

构建工具别名引用（更优雅） #

如果模块B使用webpack、Vite等构建工具，可以配置别名简化引用。以webpack为例，在模块B的webpack.config.js中添加：

const path = require('path');

module.exports = {
  resolve: {
    alias: {
      'module-a': path.resolve(__dirname, '../shared/dist/production/main.js')
    }
  }
};

之后在代码中就可以直接写import moduleA from 'module-a'，无需关心路径。

3. 确保构建顺序 #

用Gradle管理整个项目时，需要让模块B的构建任务依赖模块A的打包任务，保证先完成A的打包再处理B：

1. 在项目根目录的settings.gradle.kts中声明两个模块：

include(":module-a", ":module-b")

2. 在模块B的build.gradle.kts中添加依赖：

tasks.named("build") {
    // 绑定生产环境打包任务，开发环境可替换为browserDevelopmentWebpack
    dependsOn(":module-a:browserProductionWebpack")
}

执行./gradlew build时，会自动先执行模块A的打包任务，再构建模块B。

4. IntelliJ IDEA识别配置 #

为了让IDEA提供正确的代码提示，需要将模块A的输出目录标记为模块B的依赖：

• 打开File > Project Structure
• 选择模块B，切换到Dependencies标签
• 点击+按钮，选择JARs or directories，选中模块A的输出目录，将其添加为依赖，类型选择Library或Resource

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