为何Node.js CLI可用mysql.js，命令行运行脚本却提示模块缺失？

这种情况我碰到过好几次——Node交互式CLI能正常加载mysql模块，一跑脚本就报错找不到，大概率是模块安装路径、工作目录或者Node版本的问题，我给你一步步排查解决：

1. 确认mysql模块是本地安装到项目目录的 #

Node CLI能调用模块，可能是你之前用npm install -g mysql全局装了，但脚本运行时默认优先读取当前项目根目录下的node_modules，全局模块不会被脚本自动识别。

解决步骤：

• 打开命令行，先切换到你的项目根目录：

  cd d:\projects\prj_nodetest
  

• 执行本地安装命令（加上--save会把依赖写入package.json，方便后续管理）：

  npm install mysql --save
  

  安装完成后，检查项目目录下是否生成了node_modules文件夹，且里面有mysql子目录。

2. 检查运行脚本时的工作目录 #

如果你直接在其他目录（比如d:\根目录）运行node projects/prj_nodetest/234.js，Node会在当前命令行的工作目录（也就是d:\）下找node_modules，自然找不到项目里的mysql模块。

解决步骤：

• 务必先切换到项目根目录，再运行脚本：

  cd d:\projects\prj_nodetest
  node 234.js
  

3. 验证Node.js版本的一致性 #

如果你装了多个Node版本（比如用nvm管理），可能CLI用的是一个版本，命令行里运行node时是另一个版本，不同版本的模块路径不互通，导致CLI能找到但脚本找不到。

解决步骤：

• 在Node.js CLI里输入：

  process.version
  

  记下版本号（比如v16.18.0）
• 在命令行里输入：

  node -v
  

  对比两个版本是否一致。如果不一致，切换到同一个版本后，重新在项目目录下安装mysql模块。

4. 清理npm缓存并重新安装依赖 #

有时候npm缓存损坏会导致模块安装不完整，表面上看装成功了，但实际文件缺失。

解决步骤：

• 清理npm缓存：

  npm cache clean --force
  

• 删除项目目录下的node_modules文件夹和package-lock.json文件
• 重新安装所有依赖：

  npm install
  

5. 排查模块加载路径（进阶调试） #

如果上面的方法都没用，可以在脚本里打印Node的模块搜索路径，看看项目的node_modules是否在搜索列表里：

const mysql = require('mysql');
console.log(module.paths);

运行脚本后，检查输出里是否包含d:\projects\prj_nodetest\node_modules。如果没有，说明Node的模块加载机制异常，建议重新安装Node.js。

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