使用expo init创建React Native项目报Node.js v12.4.0不支持错误
Expo初始化项目Node版本报错排查方案
触发场景:Windows系统全局安装Node.js v12.4.0、未配置nvm版本管理工具时,执行
expo init projectName触发版本校验拦截
报错根本原因
当前安装的Node.js v12.4.0不在已安装expo-cli支持的版本列表内:
- 12.x系列Node需满足>=12.13.0 <13.0.0的区间要求,现有12.4.0版本低于该区间的最低阈值
- expo-cli仅做版本合规性校验,不会自动帮助升级Node环境,只要版本不在支持列表内就会直接中断项目初始化流程
无nvm环境下的分步操作
- 完全卸载现有旧版Node.js
打开Windows「设置-应用-已安装的应用」,搜索Node.js对应程序执行卸载,卸载完成后手动清理残留路径:C:\Program Files\nodejs、C:\Users\当前登录用户名\AppData\Roaming\npm,清除旧版本的全局配置残留,避免新安装的Node被旧路径的配置干扰 - 安装满足版本要求的Node.js
下载对应正式版安装包,可选兼容版本包括12.x系列最高LTS版(12.22.12)、14.x系列LTS版(14.21.3),全程按安装向导默认选项完成安装,安装结束后新开命令行窗口,执行node -v验证输出的版本号在要求区间内 - 重装兼容的expo-cli
旧版本expo-cli可能与新装Node存在依赖兼容问题,执行全局重装命令:npm install -g expo-cli,安装完成后执行expo --version确认程序可正常调用,再重新执行初始化命令即可
小提示:如果后续有不同项目对应不同Node版本的切换需求,可后续安装nvm-windows工具做多版本管理,当前报错无需额外配置工具即可直接解决。
内容的提问来源于stack exchange,提问作者Jobin Varghese
相关产品推荐
相关产品推荐

