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

Expo Router配置正确却始终显示‘Welcome to Expo’页面的排查求助

Expo Router配置正确却始终显示‘Welcome to Expo’页面的排查求助

大家好,我最近在搭建Expo Router项目时遇到了个卡壳的问题——明明各项配置都按文档要求来了,但App启动后始终停留在默认的「Welcome to Expo」页面,完全不渲染我自己写的InitScreen组件。折腾了好一阵还是没解决,想请大家帮忙看看还有哪些地方没排查到?

我的项目环境

  • Expo SDK: 53.0.20
  • expo-router: ~5.1.4
  • React Native: 0.79.5
  • 开发平台: Windows

核心配置信息

入口文件配置(package.json)

我已经把入口指定为expo-router的标准入口:

{ "main": "expo-router/entry" }

根布局组件(app/index.tsx)

根布局里我直接引入了InitScreen,并且隐藏了导航栏:

import InitScreen from "@/screens/InitScreen";
import { Stack } from "expo-router";

export default function Index() {
  return (
    <>
      <Stack.Screen options={{ headerShown: false }} />
      <InitScreen />
    </>
  );
}

App全局配置(app.json)

也已经添加了expo-router插件和web端的metro配置:

{
  "expo": {
    "scheme": "impulse",
    "web": { "bundler": "metro" },
    "plugins": ["expo-router"]
  }
}

已经尝试过的排查动作

✅ 反复确认package.json的入口确实是expo-router/entry
✅ 用npx expo start -c清除Metro缓存后重启
✅ 彻底删除node_modules、lock文件后重新安装依赖
✅ 检查tsconfig.json的paths配置,确保@/能正确指向项目根目录
✅ 核对app目录结构,确认是Expo Router要求的标准结构
✅ 单独验证InitScreen组件,确认它能正常渲染且导出正确

当前的问题表现

  • 预期效果:App启动后直接渲染InitScreen作为根页面
  • 实际效果:不管怎么折腾,始终显示默认的「Welcome to Expo」页面

想请教大家

除了上面这些排查点,还有哪些容易被忽略的配置项或者潜在坑点需要检查才能解决这个问题?

内容来源于stack exchange

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.04.07 13:30:27