普通JS Node项目是否有等价于tsconfig paths的路径别名配置方案？

架构老林

2026-10-3

结论

可以实现，Node.js 原生生态和第三方工具均支持纯 ES 模块项目的路径别名配置，以下是两种常用实现方案：

方案1：Node.js 原生配置（无额外依赖，推荐）

Node.js v14.18.0 / v16.0.0 及以上版本原生支持通过 package.json 的 imports 字段配置别名，无需安装任何第三方包：

首先确保你的项目已经开启 ES 模块支持，在 package.json 中添加配置：

{
  "type": "module"
}

继续在 package.json 中添加 imports 字段配置别名：

{
  "type": "module",
  "imports": {
    "#src/*": "./src/*",
    "#images/*": "./src/assets/images/*",
    "#styles/*": "./src/assets/styles/*",
    "#components": "./src/components/index.js",
    "#layout/*": "./src/layout/*",
    "#pages/*": "./src/pages/*"
  }
}

使用时直接导入即可，示例：

import Header from '#layout/Header.js'
import getList from '#src/api/list.js'

注意：Node.js 原生规范推荐内部别名以 # 开头，避免和 npm 公共包名产生命名冲突，如果需要完全复用 TypeScript 项目中 @ 开头的别名规则，可以使用第二种方案。

方案2：第三方包实现@开头别名（和TS配置完全一致）

如果需要和你之前 TS 项目的 @ 开头别名规则完全对齐，可以通过 esmodule-alias 包实现：

安装依赖：

npm install esmodule-alias

在项目的入口文件最顶部引入注册逻辑：

// 必须放在所有其他import语句之前
import 'esmodule-alias/register.js'

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

{
  "type": "module",
  "_moduleAliases": {
    "@src": "src",
    "@images": "src/assets/images",
    "@styles": "src/assets/styles",
    "@components": "src/components",
    "@layout": "src/layout",
    "@pages": "src/pages"
  }
}