执行npx expo export:web后导出的index.html显示空白页，求排查原因

• 用本地服务器托管静态资源，而非直接打开html
  直接双击打开web-build里的index.html会导致浏览器无法解析相对路径的静态资源，必须用本地服务器运行。执行npx serve web-build，然后访问终端给出的本地地址（通常是http://localhost:3000），看页面是否正常显示。

• 检查导出过程的终端输出
  重新执行npx expo export:web，逐行查看终端日志：

  • 若有红色编译错误，优先修复（比如组件语法错误、依赖缺失、不支持Web的第三方库）
  • 若有黄色警告，确认是否影响渲染（比如废弃API调用、未配置Web适配项）

• 验证Web适配依赖与配置
  确保项目已安装Web必需依赖：

  npm install expo-web-browser @expo/webpack-config
  

  检查app.json中的Web配置，确认bundler设置正确：

  "web": {
    "bundler": "webpack"
  }
  

• 排查浏览器控制台错误
  打开浏览器开发者工具（F12）切换到Console面板：

  • 查看是否有模块缺失、变量未定义、语法错误等信息，这些是导致页面空白的直接原因
  • 切换到Network面板，检查静态资源（js、css）是否加载成功，若有404错误，说明资源路径配置异常

• 清除缓存后重新导出
  执行以下步骤重置项目环境：

  # 清除Expo缓存
  npx expo start --clear
  # 删除依赖锁文件与node_modules
  rm -rf node_modules package-lock.json
  # 重新安装依赖
  npm install
  # 重新导出Web项目
  npx expo export:web
  

内容的提问来源于stack exchange，提问作者Şahan Hasret