配置TypeScript Node项目运行npm run build时报node未识别错误如何解决

故障触发场景 #

已完成TypeScript + Node项目的基础配置：

• 安装开发依赖：npm i --save-dev typescript ts-node @types/node
• 生成TS配置文件：npx tsc --init
• 已修改tsconfig.json配置：
  • 取消注释并修改"lib": ["ES6"]
  • 取消注释并修改"outDir": "./build"
  • 取消注释"noImplicitAny": true
  • 与compilerOptions同级新增配置："exclude": ["node_modules"]
• package.json中已新增script配置："build": "npx tsc"
• 全局node、npm可正常执行，运行npm run build时报错：'"node"' is not recognized as an internal or external command, operable program or batch file

解决方案 #

按优先级尝试以下操作：

1. 重启终端/电脑
   刚配置完Node环境变量后，npm运行脚本时会单独拉起新的shell进程，未重启的情况下新进程可能无法读取到环境变量，重启后重试即可。
2. 清理缓存重装依赖
   依次执行以下命令：

npm cache clean --force
# Mac/Linux执行：
rm -rf node_modules package-lock.json
# Windows系统执行：
rmdir /s /q node_modules && del package-lock.json

npm install

3. 修改build脚本调用方式
   将package.json中的build脚本替换为直接调用本地tsc二进制文件，跳过npx寻址：

• 通用版本（兼容Mac/Linux/Windows PowerShell/Git Bash）："build": "./node_modules/.bin/tsc"
• Windows CMD专属版本："build": ".\\node_modules\\.bin\\tsc"

4. 修正npm脚本执行shell配置
   npm运行脚本时默认拉起的shell与你当前使用的终端不一致，会导致环境变量读取失败，执行以下命令指定shell为你常用的终端即可：

• 指定为PowerShell：npm config set script-shell powershell
• 指定为Git Bash：npm config set script-shell "C:\\Program Files\\Git\\bin\\bash.exe"（路径替换为你本地Git Bash的实际安装路径）

5. 全局重装npx
   如果直接执行npx tsc也报相同错误，执行npm install -g npx重装全局npx后重试。

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