Npm脚本运行失败：提示'.'不是内部或外部命令如何解决

直接触发原因 #

报错本质是 Windows原生终端对Bash风格脚本语法的不兼容：

• 所有以./开头的路径写法，是Linux/macOS下Bash的路径解析规则，Windows CMD/PowerShell会把路径开头的.拆分成独立的待执行命令，直接抛出“'.' 不是内部或外部命令”的错误。
• 脚本中的export NODE_ENV=test语法是纯Bash专属写法，Windows原生终端同样无法识别。
• 从报错日志可以定位，崩溃发生在prestart脚本的第二段命令执行时，路径解析第一步就失败，没有走到实际的功能逻辑。

排查步骤 #

• 确认当前执行npm命令的终端：如果是Windows自带的CMD、PowerShell，即可确认是语法兼容问题。
• 检查项目根目录.npmrc文件，查看是否有script-shell配置项：如果该配置指向CMD/PowerShell，即使换用其他终端，npm也会强制调用指定shell执行脚本。

解决方案 #

推荐方案：改造脚本为全平台兼容写法 #

移除所有脚本中的平台专属硬编码，实现一套配置全系统可运行：

• 去掉所有./node_modules/.bin/xxx的手动路径拼接：npm执行脚本时会自动把当前项目的node_modules/.bin目录注入到系统PATH，直接写命令名即可被各平台正常识别。
• 替换Bash专属的export环境变量写法：安装cross-env开发依赖，实现跨平台统一的环境变量设置。
  改造后的package.json脚本参考：

"scripts": {
  "lint": "eslint",
  "test": "cross-env NODE_ENV=test mocha --timeout 100000",
  "prestart": "sequelize db:migrate && sequelize db:seed:all",
  "start": "pm2 start pm2server.config.js",
  "poststart": "pm2 log HumanR"
}

这种写法无需更换终端，Windows、Linux、macOS环境下均可正常执行，不会破坏团队跨系统协作的兼容性。

备选方案：切换兼容终端 #

如果不想调整现有package.json配置，可以在Windows环境下使用Git Bash、WSL这类兼容Bash语法的终端执行npm脚本，这类终端可以正常识别./路径、export环境变量的写法，不会触发路径解析错误。

常见避坑点 #

• 不要为了适配Windows把./强行改成Windows专属的.\反斜杠路径写法，这种写法会直接导致Linux、macOS环境下的脚本执行失败。
• 不要手动删除node_modules/.bin下的命令可执行文件，改造脚本后如果仍报错，重新执行npm install即可恢复可执行文件的软链接。

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