如何结合node-loader与native addon配置相对路径解决加载失败问题

看起来你遇到的问题是Webpack在生产构建时把Native Addon的相对路径硬编码成了你开发机器的绝对路径，导致其他机器上找不到对应的.node文件。下面是几个针对性的解决方案：

1. 正确配置Webpack处理.node文件 #

首先确保你的Webpack配置里用file-loader（或者Webpack 5+的内置asset/resource）来处理.node文件，并且设置相对输出路径，避免生成绝对路径引用：

module.exports = {
  // ...其他配置
  module: {
    rules: [
      {
        test: /\.node$/,
        use: {
          loader: 'file-loader',
          options: {
            name: '[name].[ext]',
            outputPath: 'lib/', // 和你开发时的lib目录对应
            publicPath: './lib/', // 关键：设置为相对路径，而非绝对路径
            esModule: false // 用require导入时建议关闭这个选项
          }
        }
      }
    ]
  }
}

如果是Webpack 5，也可以用内置资源模块替代file-loader：

{
  test: /\.node$/,
  type: 'asset/resource',
  generator: {
    filename: 'lib/[name].[ext]',
    publicPath: './lib/'
  }
}

2. 修复Electron（如果是Electron应用）的__dirname问题 #

如果这是Electron应用，Webpack默认会在生产模式下替换__dirname为绝对路径，导致运行时找不到文件。你需要在主进程的Webpack配置中保留原生的__dirname：

module.exports = {
  target: 'electron-main',
  node: {
    __dirname: false, // 禁止Webpack替换__dirname为绝对路径
  },
  // ...其他配置
}

然后在代码里用动态路径导入，确保引用的是相对当前脚本的路径：

// CommonJS写法
const path = require('path');
const main = require(path.join(__dirname, './lib/main.node'));

// ES模块写法（如果用import）
import path from 'path';
import { fileURLToPath } from 'url';
const __dirname = path.dirname(fileURLToPath(import.meta.url));
const main = await import(path.join(__dirname, './lib/main.node'));

3. 验证构建输出 #

构建完成后，检查输出目录（比如dist）下是否存在lib/main.node文件，同时打开main.prod.js搜索main.node的引用路径，确认是相对路径（比如./lib/main.node）而非你开发机的绝对路径（/Users/.../app/lib/main.node）。

为什么开发环境正常？ #

开发模式下Webpack通常使用dev-server或者保留了相对路径的引用逻辑，不会把路径硬编码成绝对路径，所以在你的开发机上能正常找到文件。但生产构建时的优化会把路径转换成绝对路径，导致其他机器无法匹配这个本地路径。

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