Node.js中如何避免require导入时书写多层../相对路径？

完全可以规避多层../的繁琐写法，也支持自定义路径前缀实现你想要的导入效果，以下是经过生产验证的常用方案：

1. 原生支持方案（无额外依赖，推荐优先使用） #

Node.js 12及以上版本原生支持路径别名配置，不需要安装任何第三方包，只需要在项目根目录的package.json中添加imports字段即可：

{
  "imports": {
    "#classes/*": "./classes/*",
    "#utils/*": "./utils/*",
    "#etc/*": "./etc/*"
  }
}

配置完成后，任意层级的文件中都可以直接用别名导入，不会受当前文件所在目录影响：

const ApiError = require('#classes/ErrorClass');
const ex = require('#classes/ApiClass');
const ex1 = require('#utils/utils');
const ex2 = require('#etc/etc');

注意：原生规范要求自定义别名必须以#开头，目的是和node_modules下的第三方包名做区分，避免命名冲突。如果一定要使用不带#的前缀（比如你示例中的mypath/xxx格式），可以用下面的第三方轻量方案实现。

2. 轻量第三方包方案（兼容低版本Node，支持自定义无前缀别名） #

对于Node.js 12以下的版本，或者需要自定义不带#的别名前缀，可以使用module-alias这个轻量包，配置步骤很简单：

• 安装包到项目依赖

npm install module-alias

• 在根目录package.json中添加自定义别名配置

{
  "_moduleAliases": {
    "mypath": "./classes",
    "utils": "./utils",
    "etc": "./etc"
  }
}

• 在项目入口文件的最顶部注册别名

require('module-alias/register');

配置完成后就可以直接用你预期的写法导入：

const ApiError = require('mypath/ErrorClass');

3. 零配置快速方案（适合小型项目） #

如果不想做任何配置，可以直接在项目入口文件顶部把项目根目录挂到全局变量上：

global.__root = __dirname;

之后所有文件中都可以用绝对路径导入模块，完全不需要计算相对层级：

const ApiError = require(`${__root}/classes/ErrorClass`);

这个方案的缺点是IDE默认无法识别全局变量的路径提示，大型项目不推荐使用。

其他可选方案 #

如果你的项目本身使用了TypeScript或者构建工具，可以直接用工具自带的别名能力，不需要额外引入其他包：

• TypeScript项目：在tsconfig.json的compilerOptions.paths字段配置路径映射
• 使用Webpack/Vite/Rollup等构建工具的项目：在工具配置的alias字段添加路径映射
• 使用Egg/Nest等Node框架的项目：框架本身自带路径别名配置能力，直接查阅对应框架文档配置即可

避坑提示：不要使用修改NODE_PATH环境变量的旧方案，该特性已经被Node.js官方标记为废弃，跨环境部署时很容易出现路径解析错误，兼容性极差。

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