Xcode 15中extern "C"内导入C++模块报错的原因与解决方法

问题重现 #

涉及代码片段：

#ifdef __cplusplus
extern "C" {
#endif

#ifndef _ZLIB_H
#include "zlib.h"
#endif
...

尽管行业规范不建议在extern "C"代码块内使用#include，但大量存量项目和第三方库仍采用该写法。这类代码在Xcode 14及更早版本可正常编译，但在Xcode 15中会触发错误：

Import of C++ module appears within extern "C" language linkage specification

Xcode 15的关键变更 #

Xcode 15默认启用了**C模块（C Modules）**支持，同时强化了对extern "C"块内代码的语法检查。当在extern "C"块中包含头文件时，若该头文件被编译器识别为C模块（例如zlib这类兼容C/C的库，其头文件在模块模式下会被当作C模块处理），就会触发冲突错误——extern "C"指定的是C语言链接规范，而模块导入属于C专属特性，两者无法共存于同一代码块。

恢复Xcode 14编译行为的方案 #

方案1：禁用C++模块支持 #

在Xcode项目的Build Settings中修改以下配置：

• 找到Enable C++ Modules (C++20 Modules and Modules TS)，将其设置为NO
• 若项目包含多个Target，需确保每个Target的对应设置也同步修改

方案2：重构代码结构（长期推荐） #

如果具备代码修改权限，建议调整代码结构，将#include语句移出extern "C"块，从根源上避免规范冲突。调整后的示例代码：

#ifndef _ZLIB_H
#include "zlib.h"
#endif

#ifdef __cplusplus
extern "C" {
#endif
...
#ifdef __cplusplus
}
#endif

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