Xcode 13.4.1迁移后出现module 'fmt'重定义等编译问题求助

错误信息 #

Lexical or Preprocessor Issue Group - Redefinition of module 'fmt'

（错误导航区域截图：）

问题背景 #

从Xcode 12迁移至Xcode 13.4.1后编译出现12个错误，分为Lexical or Preprocessor Issue Group和Parse Issue两类，核心问题为fmt模块重定义。已查阅stackoverflow和github相关内容，但找到的多为Lexical or Preprocessor Issue - ***.h file not found类解决方案，未解决当前问题。

解决方案 #

• 排查重复依赖来源
  确认项目是否通过多种方式引入了fmt库，导致模块重复定义：

  • 检查Podfile，若存在重复的fmt相关依赖，执行pod deintegrate清理后重新执行pod install
  • 查看Swift Package Manager依赖列表，移除重复添加的fmt包
  • 检查项目目录，确认是否手动导入了fmt源码或.framework文件，与包管理工具的引入产生冲突

• 清理Xcode缓存

  • 清理项目构建缓存：使用快捷键Cmd+Shift+K清理项目，Cmd+Option+Shift+K清理构建文件夹
  • 删除Derived Data：打开Xcode -> Settings -> Locations，点击Derived Data后的路径，删除对应项目的缓存文件夹
  • 清理模块缓存：删除~/Library/Developer/Xcode/DerivedData/ModuleCache.noindex下的fmt相关缓存文件

• 检查模块映射配置

  • 搜索项目中的module.modulemap文件，确认是否存在多个文件定义了fmt模块，保留一个有效定义，移除重复文件
  • 查看Build Settings中的Module Map File选项，确保仅指向一个正确的模块映射文件

• 调整Build Settings参数

  • 检查Defines Module设置：仅在fmt库自身的Target中开启该选项，主项目或其他依赖Target需关闭
  • 梳理Header Search Paths和Framework Search Paths，移除重复的fmt相关路径，避免多次引入

• 适配Xcode版本

  • 确认当前使用的fmt库版本兼容Xcode 13.4.1，尝试更新至最新稳定版本
  • 若为自定义fmt模块，检查模块定义语法是否适配Xcode 13内置的Clang版本，修正语法问题

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