Xcode 26.4构建React Native iOS项目遇fmt常量表达式错误的根因与解决

你遇到的这个编译错误，本质是Xcode 16.4（推测你输入的26.4是笔误）升级后，Clang编译器对consteval函数的常量表达式校验变得更严格，而React Native 0.81.x内置的fmt库中，部分格式化字符串的写法不符合新版本编译器的规则，导致fmt::basic_format_string的调用无法被解析为合法的常量表达式，最终触发构建失败。

按优先级给你三个可行方案：

方案1：升级React Native到兼容版本 #

React Native官方在0.82.0及后续版本已经修复了这个编译器兼容性问题，步骤如下：

• 运行npx react-native upgrade升级到最新稳定版（至少0.82.x）
• 重新安装依赖：npm install 或 yarn install
• 进入iOS目录执行pod install
• 清理Xcode的DerivedData和构建缓存后重新构建

方案2：临时修改fmt库代码 #

如果暂时没法升级RN，可手动修改项目里的fmt库代码：

1. 在Xcode的Pods目录下找到fmt库，打开include/fmt/core.h文件
2. 找到触发错误的fmt::basic_format_string相关代码，把consteval关键字替换成constexpr
3. 保存后重新编译项目（注：这是临时 workaround，可能存在潜在风险，建议后续尽快升级RN）

方案3：降级Xcode版本 #

如果前两个方案都不适用，可把Xcode降级到16.3或更早版本，旧版本的Clang对consteval的校验规则没那么严格，能兼容RN 0.81.x的fmt库写法。

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