Expo SDK51卡在「Welcome to Expo」界面问题求助

排查及解决步骤 #

• 核对路由文件结构
  Expo SDK51采用文件系统路由，确保app目录存在_layout.tsx（或js/jsx版本）作为根路由入口，标签栏组件需在这个文件里正确配置导出。如果缺少_layout.tsx，Expo会 fallback到默认欢迎界面。同时确认app/index.tsx（或对应首页文件）存在且无语法错误。

• 检查项目入口配置
  打开package.json，确认main字段为"main": "expo-router/entry"，若被修改为其他路径，会导致Expo无法加载自定义路由代码。

• 深度清理缓存
  执行彻底清理命令，同时手动删除项目根目录的.expo文件夹：

  npx expo start --clear
  

• 移除冲突文件
  检查项目根目录是否存在App.tsx/App.jsx，Expo会优先加载根目录的App文件而非app目录的路由文件，若有则删除或重命名该文件。

• 验证依赖版本
  确认package.json中expo-router版本与SDK51兼容（对应版本约为~3.5.12），版本不匹配会导致路由加载异常，可重新安装适配版本：

  npm install expo-router@~3.5.12
  

• 快速测试定位问题
  创建极简的app/index.tsx文件测试：

  export default function Home() {
    return <h1>自定义首页</h1>;
  }
  

  启动后若能显示该内容，说明原标签栏组件或_layout配置存在错误，逐步排查组件内的语法、依赖问题。

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