使用pkg打包时无法找到'@...'模块，配置_moduleAliases后如何解决？

根本原因 #

pkg依赖静态分析扫描项目的依赖路径，而module-alias的别名是运行时才注入生效的，静态扫描阶段无法识别@开头的自定义路径，因此会抛出模块不存在的错误。

可落地的解决方法 #

• 方法1：同步配置pkg的别名规则
  在package.json中新增pkg的alias配置，和你现有的_moduleAliases规则完全对齐即可：

{
  "pkg": {
    "alias": {
      "@root": "./",
      "@": "./"
    },
    "assets": ["./**/*.js"],
    "scripts": ["./**/*.js"]
  }
}

assets和scripts字段用来告知pkg需要把项目下所有js文件纳入打包范围，避免遗漏依赖。

• 方法2：调整module-alias的注册时机
  确保在项目入口文件的第一行就注册module-alias，注册逻辑不能使用别名引入，必须用原生路径：

// 入口文件首行必须先写这行注册代码
require('module-alias/register')
// 后续再使用别名引入其他模块
const { jwt } = require('@/config')

• 方法3：预编译替换别名（兼容复杂场景）
  如果前两种方法不生效，可以用babel-plugin-module-resolver在打包前把所有别名替换为相对路径，再用pkg打包编译后的产物：

1. 安装依赖：npm install babel-plugin-module-resolver --save-dev
2. 项目根目录新增babel配置文件.babelrc：

{
  "plugins": [
    ["module-resolver", {
      "alias": {
        "@root": "./",
        "@": "./"
      }
    }]
  ]
}

3. 先执行babel编译代码，再对编译后的产物执行pkg打包命令即可。

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