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+）。