Expo启动忽略TypeScript错误，如何让编译报错阻断运行？

在使用Expo结合TypeScript开发时，执行expo start甚至构建操作时，TypeScript错误会被直接忽略——VS Code能正常提示错误，但应用仍能重载并在Expo Go中运行，很容易引发隐性的运行时问题。我希望实现只要存在TypeScript编译错误，就直接阻断应用重载、启动或构建流程。

当前我的tsconfig.json配置如下（已添加noEmitOnError但未生效）：

{
  "compilerOptions": {
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "noEmitOnError": true
  },
  "extends": "expo/tsconfig.base"
}

解决方法 #

1. 理解核心原因 #

Expo默认使用@babel/preset-typescript处理TypeScript，这个工具只负责语法转译，不会执行类型检查。所以tsconfig里的noEmitOnError对Expo的构建/启动流程没有影响，必须额外添加独立的类型检查步骤。

2. 给启动/构建命令添加前置类型检查 #

修改package.json中的scripts，在Expo命令前先执行TypeScript类型检查：

"scripts": {
  "start": "tsc --noEmit && expo start",
  "build:android": "tsc --noEmit && expo build:android",
  "build:ios": "tsc --noEmit && expo build:ios"
}

之后执行npm start或构建命令时，会先运行tsc --noEmit做全量类型检查，一旦发现错误就会终止后续流程，不会启动Expo或执行构建。

3. 开发时实时监控类型错误（可选） #

如果想在开发过程中实时检测错误，避免无效重载：

• 单独开一个终端窗口，运行tsc --watch --noEmit，它会持续监听文件变化，一旦出现类型错误就立即输出提示。
• 在另一个终端正常运行expo start，这样只要类型检查不通过，你就能及时发现问题，不用等到重载后才察觉。

4. 优化tsconfig配置顺序 #

确保自定义配置能覆盖Expo的基础配置，调整tsconfig.json的结构（不影响功能，但更规范）：

{
  "extends": "expo/tsconfig.base",
  "compilerOptions": {
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "noEmitOnError": true
  }
}

noEmitOnError虽然对Expo转译无效，但对tsc命令依然有效，保留即可。

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