使用Babel运行JavaScript文件失败的问题排查求助

一、先搞定ERR_MODULE_NOT_FOUND错误 #

• 核对./config的文件路径：确认src目录下确实有config.js（或者.mjs/.cjs，看你用的模块类型），注意文件名大小写——Linux和macOS是区分大小写的，别写错。
• 检查Babel配置：项目根目录的babel.config.json（或.babelrc）里，要确保装了@babel/preset-env预设，并且配置正确支持ES模块。
• 重装依赖：跑一遍npm install，把所有依赖重新装一遍，防止依赖缺漏或者损坏；另外要确认@babel/core、@babel/cli这些核心包是装在项目本地的，别只装全局。

二、解决ReferenceError: module is not defined错误 #

这个问题基本是ES模块和CommonJS混用搞出来的，按下面步骤排查：

• 把项目声明为ES模块：在package.json里加一行"type": "module"，告诉Node.js整个项目用ES模块规范，这样所有.js文件默认按ES模块处理。
• 调整Babel的输出格式：如果要兼容CommonJS，在Babel配置里把modules设为false（让Babel保留ES模块语法，交给Node.js或者后续工具处理），或者设为"commonjs"（把ES模块转成CommonJS）。举个配置例子：

{
  "presets": [
    ["@babel/preset-env", { "modules": false }]
  ]
}

• 统一模块语法：别在代码里同时用import和module.exports/require，全换成ES模块的import和export语法。
• 改执行命令：如果用babel-node运行，旧版Node.js可能要加--experimental-modules，新版直接用node --loader babel-node src/server.js，别直接用babel命令编译后执行，容易出现模块不兼容的问题。

三、额外验证步骤 #

• 先跳过Babel测试：直接跑node src/server.js，看看模块引入本身有没有问题，先排除Babel之外的问题。
• 对齐Babel版本：确保@babel/core、@babel/cli、@babel/preset-env这些包的版本一致，版本不匹配也容易出各种奇怪的错。

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