如何在Express.js（Node.js）中配置_moduleAliases模块别名

• 是否需要Node.js包？视环境而定：原生CommonJS环境需借助第三方包，ESM环境（Node.js 14.13+）可直接通过package.json配置，无需额外包。

需求场景 #

需要规范路径引用，将原本的相对路径：

var file = "../module/filePath.js";
var file2 = "../module/filePath2.js";

替换为更简洁的别名形式：

var file = "@module/filePath";
var file2 = "@module/filePath2";

实现方案 #

方案一：CommonJS环境（使用module-alias包） #

1. 安装依赖

npm install module-alias --save

2. 在package.json中添加别名配置

{
  "_moduleAliases": {
    "@module": "./module"
  }
}

3. 在项目入口文件顶部注册别名

require('module-alias/register');

完成后即可直接使用别名引用模块。

方案二：ESM环境（无需额外包） #

Node.js 14.13及以上版本支持在package.json中配置imports字段：

{
  "imports": {
    "@module/*": "./module/*"
  }
}

配置完成后，即可用ESM语法直接引用：

import file from '@module/filePath.js';

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