全局expo-cli已弃用，执行npx expo start遇问题求助
2026-7-4
解决Expo CLI弃用提示及应用运行问题
第一步：彻底清理全局expo-cli残留
全局包残留是常见诱因，先完全卸载：
- npm卸载：
npm uninstall -g expo-cli - yarn卸载（若使用yarn）：
yarn global remove expo-cli - 检查残留：运行
expo --version，若仍有版本输出，通过npm root -g找到全局包目录，手动删除expo-cli相关文件夹
第二步：修复项目依赖
进入项目根目录，执行以下操作：
- 删除旧依赖文件：
rm -rf node_modules package-lock.json yarn.lock（Windows系统用rmdir /s /q node_modules && del package-lock.json yarn.lock） - 重新安装依赖：
npm install（或yarn install） - 确认expo版本：查看
package.json中expo字段，确保为SDK 46及以上；若版本过低，执行npx expo upgrade升级到最新稳定版
第三步：用本地CLI启动项目
直接调用项目捆绑的本地CLI，若启动异常则清除缓存：
- 常规启动：
npx expo start - 清除缓存启动：
npx expo start --clear
第四步：匹配Node.js兼容版本
Expo对Node.js版本有明确要求，建议使用LTS版本（如18.x或20.x）：
- 用nvm切换版本：
nvm install 18，随后nvm use 18 - 验证版本：
node --version，确保与项目package.json中engines字段要求一致
第五步：排查环境变量问题
若以上操作无效，检查系统环境变量：
- 查看PATH变量，移除指向全局expo-cli的目录
- 重启终端，让环境变量变更生效
内容的提问来源于stack exchange，提问作者EdFrancis
相关产品推荐
相关产品推荐
