Node原生ES模块命名导入能否使用根相对路径？

在Node环境中，早先可以通过设置NODE_PATH=./src，把冗长的层级导入：

import { foo } from '../../../bar'

简化成更清晰的写法：

import { foo } from 'src/bar'

但这种方式只在使用esm包（通过node -r esm启动）时有效，对原生ES模块（package.json中配置"type": "module"）完全不兼容。下面整理可行的替代方案，以及你尝试过的方法失效的原因：

你尝试过的方法问题解析 #

• 本地依赖配置："src": "file:./src"这种写法是把src当作独立包引用，但src目录下没有合法的package.json定义模块导出，无法正常解析
• 符号链接到node_modules：Node会把node_modules下的文件默认当作CommonJS模块处理，即使项目是ES模块，也会触发模块格式不匹配，导致命名导入失效
• 工作区配置："workspaces": ["src"]用于管理多包项目，单包场景下会把src识别成子包，同样存在模块格式识别错误的问题
• imports字段：你之前的配置"#src": "./src"缺少通配符和文件后缀，原生ES模块要求必须指定完整文件名（包括后缀），--experimental-specifier-resolution=node是实验性特性，本身不稳定，不能依赖它省略后缀
• 自定义加载器：加载器API文档不完善，且需要处理大量边缘情况，不适合快速解决问题

无额外工具的原生解决方案 #

如果不想引入Babel、Webpack等工具，目前唯一可行的原生方案是正确配置imports字段，接受原生ES模块的后缀要求：

1. 在项目根目录的package.json中添加带通配符的imports配置：

{
  "type": "module",
  "imports": {
    "#src/*": "./src/*.js"
  }
}

2. 导入时使用带#前缀的路径并保留.js后缀：

import { foo } from '#src/bar.js'

这种方式完全基于Node原生ES模块支持，不需要任何额外工具，唯一的限制是必须写全文件后缀——这是原生ES模块的规范要求，并非bug。

轻量妥协方案（无需完整构建链） #

如果实在不想写文件后缀，可以用Babel的模块解析插件做轻量转译，不需要完整的构建流程：

1. 安装必要依赖：

npm install --save-dev @babel/core @babel/node @babel/plugin-module-resolver

2. 创建.babelrc配置文件：

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

3. 用babel-node启动项目：

babel-node --extensions '.js' src/index.js

这样就能继续使用import { foo } from 'src/bar'的简洁写法，无需添加后缀。

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