You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

创建Next.js应用时Node版本异常:已切换仍提示使用旧版Node

解决NVM切换Node版本后创建Next.js仍报错的问题

排查终端中npm与Node的关联匹配性

先确认当前终端里npm对应的Node版本是否正确,避免全局npm残留干扰:

  • 执行 npm -v 查看当前npm版本,再执行 which npm 检查npm路径,正常应该指向当前激活的Node版本目录(比如~/.nvm/versions/node/v18.20.2/bin/npm)
  • 若路径不符,先卸载全局npm:npm uninstall -g npm,再重新激活目标Node版本:nvm use 18.20.2,此时会自动使用该版本自带的npm

刷新Shell配置或重启终端

nvm的版本设置可能未在当前终端生效:

  • 直接关闭当前终端,重新打开后执行 node -v 和 npm -v 确认版本
  • 或执行对应Shell的刷新命令:source ~/.bashrc(bash环境)或 source ~/.zshrc(zsh环境)

清理缓存并重装目标Node版本

若Node版本文件损坏导致关联异常:

  • 卸载目标版本:nvm uninstall 18.20.2
  • 清理nvm缓存:nvm cache clear
  • 重新安装版本:nvm install 18.20.2
  • 设置为默认版本:nvm alias default 18.20.2

直接指定Node版本执行创建命令

跳过默认版本可能的异常,强制用目标版本创建Next.js应用:

nvm use 18.20.2 && npx create-next-app@latest

或者使用20.x版本:

nvm use 20.13.1 && npx create-next-app@latest

检查系统级Node版本的优先级干扰

确认系统自带Node不会被优先调用:

  • 执行 which node,输出路径应为~/.nvm/versions/node/v18.20.2/bin/node,而非/usr/bin/node这类系统路径
  • 若系统路径优先,调整~/.bashrc或~/.zshrc中nvm初始化代码的位置,移至文件末尾确保路径优先级最高

内容的提问来源于stack exchange,提问作者igmn

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.23 22:47:41