Node 14.X执行npm命令报错：找不到'timers/promises'模块

问题概况 #

• 切换至 Node 14.X 版本后，所有 npm 命令均无法执行，报错 Error: Cannot find module 'timers/promises'
• Gatsby 项目依赖要求 Node 14，此前运行正常，卸载并重装 Visual Studio 后出现该问题
• 尝试多个 Node 14.XX 版本、重装 nvm/Node 均无效；切换其他 Node 版本时，node-sass 依赖报错，更新适配后仍存在其他问题

解决步骤 #

1. 匹配 npm 与 Node 14 的兼容版本 #

Node 14 最稳定的配套 npm 版本为 6.x（Node 14.17.0+ 可尝试 npm 7，但兼容性问题较多），执行以下命令降级 npm：

nvm use 14
npm install -g npm@6.14.18

2. 清理缓存与项目残留文件 #

# 强制清理 npm 缓存
npm cache clean --force
# 删除项目目录下的依赖文件夹与锁文件
rm -rf node_modules package-lock.json
# 重新安装项目依赖
npm install

3. 修复 nvm 与 Node 14 的完整性 #

• 完全卸载当前 nvm，删除本地残留的 .nvm 目录（Windows 路径为 C:\Users\<你的用户名>\.nvm，Mac/Linux 为 ~/.nvm）
• 重新安装官方稳定版 nvm，避免使用第三方修改版本
• 安装 Node 14 的 LTS 最终版（兼容性最佳）：

nvm install 14.18.0
nvm use 14.18.0

4. 清理 Visual Studio 卸载后的环境残留 #

• 检查系统环境变量，删除与旧 Visual Studio 相关的 MSBuild、VC++ Build Tools 路径
• Windows 用户可安装 Node 14 兼容的编译工具：

npm install -g windows-build-tools@5.2.2

5. 切换 npm 国内镜像（避免网络导致的安装不完整） #

npm config set registry https://registry.npmmirror.com

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