大网数据广告活动
React 前端开发

React 中文参考:panicThreshold

· 52CE 我爱测

这样可以确保: - 构建不会因编译器问题而失败 - 无法优化的组件仍可正常运行 - 尽可能多的组件会被优化 - 生产部署更加稳定

panicThreshold 选项用于控制 React 编译器在编译过程中如何处理错误。

{
  panicThreshold: 'none' // 推荐
}

参考 {/reference/}

panicThreshold {/panicthreshold/}

决定编译错误是导致构建失败,还是仅跳过优化。

类型 {/type/}

'none' | 'critical_errors' | 'all_errors'

默认值 {/default-value/}

'none'

选项 {/options/}

  • 'none' (默认,推荐): 跳过无法编译的组件并继续构建
  • 'critical_errors': 仅在关键编译器错误时使构建失败
  • 'all_errors': 遇到任何编译诊断即使构建失败

注意事项 {/caveats/}

  • 生产环境构建应始终使用 'none'
  • 构建失败会阻止你的应用构建
  • 使用 'none' 时,编译器会自动检测并跳过有问题的代码
  • 更高的阈值仅在开发调试时有用

用法 {/usage/}

生产环境配置(推荐) {/production-configuration/}

对于生产构建,始终使用 'none'。这是默认值:

{
  panicThreshold: 'none'
}

这样可以确保:

  • 构建不会因编译器问题而失败
  • 无法优化的组件仍可正常运行
  • 尽可能多的组件会被优化
  • 生产部署更加稳定

开发调试 {/development-debugging/}

可临时使用更严格的阈值来定位问题:

const isDevelopment = process.env.NODE_ENV === 'development';

{
  panicThreshold: isDevelopment ? 'critical_errors' : 'none',
  logger: {
    logEvent(filename, event) {
      if (isDevelopment && event.kind === 'CompileError') {
        // ...
      }
    }
  }
}

本文来自 React 文档中文译者及贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
React 文档中文译者及贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。