使用Mocha进行单元测试时npm test命令执行失败求助

问题详情 #

执行npm test时触发两类错误：

'MochaChai\testing-callbacks\node_modules.bin' is not recognized as an internal or external command, operable program or batch file.
node:internal/modules/cjs/loader:1078
throw err;
^
Error: Cannot find module '(...)\Desktop\exercisesJS\mocha\bin\mocha.js'
at Module._resolveFilename (node:internal/modules/cjs/loader:1075:15)
...（省略栈信息）

但直接在终端运行./node_modules/.bin/mocha "test/**/*.test.js"时测试完全正常：

calculateSquare
    ✔ Should return 4 if passed 2

  1 passing (11ms)

已确认项目文件（file.js、file.test.js）、node_modules、package.json配置无误，尝试过卸载重装Mocha、清理node_modules/package-lock.json、重装Node.js和VSCode，问题仍未解决。

排查思路与解决方案 #

1. 修正package.json的scripts配置 #

npm会自动在node_modules/.bin下查找可执行文件，无需手动写全路径，检查test脚本写法：

• 错误示例（硬编码路径或转义符错误）：

  "scripts": {
    "test": "MochaChai\\testing-callbacks\\node_modules\\.bin\\mocha test/**/*.test.js"
  }
  

• 正确写法（让npm自动解析路径）：

  "scripts": {
    "test": "mocha \"test/**/*.test.js\""
  }
  

  若必须指定路径，Windows下用正斜杠替代反斜杠：

  "scripts": {
    "test": "./node_modules/.bin/mocha \"test/**/*.test.js\""
  }
  

2. 切换终端执行环境 #

Windows下npm默认用cmd，可能存在路径解析bug，尝试：

• 用PowerShell或Git Bash运行npm test
• 或在package.json中指定shell（以Git Bash为例）：

  "scripts": {
    "test": "mocha \"test/**/*.test.js\""
  },
  "config": {
    "shell": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
  

3. 移除路径中的特殊字符 #

若项目路径包含空格、中文或特殊符号，会导致npm解析路径失败，将项目移动到路径简洁的目录（如C:\dev\mocha-demo），再重新执行：

rd /s /q node_modules
del package-lock.json
npm install
npm test

4. 重置npm缓存与prefix配置 #

执行以下命令清理缓存并重置npm前缀：

npm cache clean --force
npm config set prefix "C:\Program Files\nodejs"
rm -rf node_modules package-lock.json
npm install

5. 检查系统环境变量中的PATH #

确保C:\Program Files\nodejs和C:\Program Files\nodejs\node_modules\npm\bin在系统PATH中，且没有重复或错误的路径项。

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