为什么npm link的本地ES模块包用module字段导入失败而main正常

• 核心原因：module 不是 Node.js 官方认可的包入口字段，它属于前端打包工具生态的社区非标准约定，仅会被Webpack、Rollup、Vite等前端构建工具识别，Node.js 原生执行代码的模块解析逻辑完全不会读取module字段作为包的默认入口。
• 为什么main字段可以正常工作：无论是CommonJS模块还是ES模块规范下，Node.js的模块解析逻辑都会默认读取package.json的main字段作为包的入口地址，你配置"main": "dist/bundle.js"后，Node.js导入exporter包时会自动按该路径寻址，因此能正常加载文件。
• module字段的实际作用：该字段是早期前端生态为了区分CommonJS产物入口和ES模块产物入口约定的规则，一般搭配main字段一起使用：main指向CommonJS格式产物，module指向ES模块格式产物，方便构建工具识别ES模块产物做Tree Shaking优化，这个约定从未被纳入Node.js的官方标准，因此Node原生环境不支持。

如果需要同时兼容前端构建工具和Node.js原生环境，可以同时配置三个字段：

{
  "name": "exporter",
  "version": "1.0.0",
  "type": "module",
  "main": "./dist/bundle.js", // 兼容低版本Node.js和旧版构建工具
  "module": "./dist/bundle.js", // 给前端构建工具识别ES模块入口
  "exports": {
    ".": "./dist/bundle.js" // Node.js 14.13+ 官方认可的默认入口，优先级高于main
  }
}

如果不需要兼容特别旧的Node.js版本，直接配置exports字段即可，exports的优先级高于main，是Node.js官方推荐的包入口配置方式。

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