module_not_found 错误表示node.js无法定位模块物理路径，需按五步排查：一、验证并重装缺失模块；二、修正引用路径及扩展名；三、重置npm全局路径与path；四、清理node_modules和缓存；五、检查node.js与npm版本兼容性。

如果您在运行 Node.js 项目或命令时遇到 MODULE_NOT_FOUND 错误，系统提示“Cannot find module”，则表明 Node.js 加载器无法定位指定模块的物理路径。以下是多种可立即执行的修复方法：

一、验证并重新安装缺失模块

该方法适用于因依赖未安装、安装中断或模块名拼写错误导致的报错。Node.js 会严格按 require() 或 import 语句中的名称和路径查找模块，任何偏差都会触发此错误。

1、在项目根目录下执行 npm ls （例如 npm ls express）确认模块是否已安装。

2、若输出显示 empty 或报错 missing，运行 npm install 进行本地安装。

3、若报错涉及全局命令（如 express -V 或 npm-cli.js），则需运行 npm install -g （例如 npm install -g npm）。

二、检查并修正模块引用路径

该方法针对相对路径错误、扩展名缺失或 ESM/CJS 混用场景。ESM 模式下不允许省略 .js/.mjs 后缀，且不支持隐式文件解析；CommonJS 则对扩展名更宽松。

1、打开报错中提示的源文件（如 ./app.js 或 ../build/Release/bson），检查 require() 或 import 语句中的路径是否拼写正确、大小写是否一致。

2、若使用 ESM（package.json 中含 "type": "module"），确保所有相对导入都包含完整扩展名，例如将 import utils from './utils' 改为 import utils from './utils.js'。

3、运行 node -e "console.log(require('path').resolve('./app.js'))" 验证路径是否能被正确解析到实际文件位置。

三、重置 npm 全局路径与环境变量

该方法用于解决因 Node.js 安装路径异常（如自定义路径 D:entg ode.js）、npm 全局 prefix 配置错误或 PATH 环境变量未包含全局 bin 目录引发的模块加载失败。

1、执行 npm config get prefix 查看当前全局路径。

2、若路径不指向有效目录（如不存在或权限受限），运行 npm config set prefix "D:\entg\node.js"（替换为您的实际 Node 安装根目录）。

3、将该 prefix 路径下的 bin 子目录（如 D:entg ode.jsin）添加至系统 PATH 环境变量，并重启终端。

四、清理 node_modules 与 npm 缓存

该方法适用于 node_modules 目录损坏、package-lock.json 冲突或缓存中存在不完整安装包的情况。损坏的依赖树会导致模块解析链断裂。

1、删除项目根目录下的 node_modules 文件夹及 package-lock.json 文件。

2、执行 npm cache clean --force 清除本地 npm 缓存。

3、重新运行 npm install 完整重建依赖树。

五、验证 Node.js 与 npm 版本兼容性

该方法用于排查因版本过旧或不匹配导致的模块解析机制失效问题。部分模块（如 @vue/cli-plugin-unit-jest）要求特定最低 Node.js 版本支持 ESM 或 exports 字段解析。

1、运行 node -v 和 npm -v 查看当前版本。

2、比对目标模块的 peerDependencies 要求（可在其 package.json 或 npmjs.com 页面查看），确认 Node.js 版本是否满足（例如 v18.20.7 或 v20.13.1+）。

3、若版本不符，使用 nvm 或手动安装兼容版本，并确保 npm 随之更新至推荐配套版本（如 Node.js v18 对应 npm v9+）。