如何在CMakeLists.txt中禁用C++不兼容类型编译检查

错误根因 #

该错误的核心成因是当前编译环境中uint32_t的别名是unsigned long，而遗留项目编译时的环境中uint32_t与unsigned int是等价类型，因此遗留代码在原环境可正常编译，在你的新环境出现类型不匹配报错。

方案1：在CMakeLists中关闭指针类型不匹配的编译检查 #

该方案存在一定安全风险，会屏蔽同类潜在错误，仅建议作为临时应急方案使用，且尽量仅对遗留项目目标单独设置，不要全局开启

• 若使用GCC/Clang编译器，在CMakeLists.txt中为遗留项目的编译目标添加如下选项：

# 替换尖括号内容为你的遗留项目目标名
target_compile_options(<legacy_project_target> PRIVATE -fpermissive)

-fpermissive会将指针类型不匹配这类语法错误降级为警告，允许编译通过。

• 若使用MSVC编译器，添加如下选项：

target_compile_options(<legacy_project_target> PRIVATE /w44056 /w44057)

上述两个选项会禁用指针类型转换不匹配的报错规则。

方案2：更安全的包装层方案（无需全局降低编译检查等级） #

你可以在当前项目中新增一层轻量 wrapper 隔离遗留代码的类型问题：

1. 新建单独的cpp文件（比如legacy_api_wrapper.cpp），仅在该文件中调用遗留项目的问题API，对外暴露类型完全匹配的接口
2. 仅给这个单独的wrapper文件开启宽松编译选项，其他业务代码保持原有的严格编译检查，CMake配置示例如下：

add_library(legacy_wrapper STATIC legacy_api_wrapper.cpp)
# 链接遗留项目
target_link_libraries(legacy_wrapper PRIVATE <legacy_project_target>)
# 仅给wrapper文件开启宽松编译选项
target_compile_options(legacy_wrapper PRIVATE
    $<$<OR:$<CXX_COMPILER_ID:GNU>,$<CXX_COMPILER_ID:Clang>>:-fpermissive>
    $<$<CXX_COMPILER_ID:MSVC>:/w44056 /w44057>
)

你的业务代码只需要调用legacy_wrapper对外暴露的标准接口即可，完全不会受到遗留代码类型不匹配的影响，也不会降低全局代码的编译安全等级。

方案3：对齐编译架构（无侵入无风险优先尝试） #

这类类型别名不匹配的问题大多出现在编译架构不一致的场景：如果遗留项目是32位程序，你当前项目按64位编译，就会出现uint32_t别名差异问题。你可以尝试在CMake中指定和遗留项目一致的编译架构，比如指定编译为32位：

set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -m32")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -m32")

架构对齐后uint32_t的别名会和遗留项目环境完全一致，大概率可以直接解决报错，不需要修改任何代码、也不需要关闭编译检查。

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