C / C++ / 系统课时
为项目指定 C 语言标准
为项目指定 C 语言标准
同一份 C 代码在不同编译器上可能落入不同默认语言模式,导致某台机器能编译、另一台却报错。CMake 可以把“必须使用哪一版 C 标准”写进目标配置,让标准要求随工程一起进入构建流程。
学习目标
- 用 CMake 为目标声明 C11 等语言标准要求
- 理解
C_STANDARD、C_STANDARD_REQUIRED与C_EXTENSIONS的作用 - 通过实际构建验证标准配置已经生效
把标准要求写到目标上
对于可执行文件或库,优先把语言标准绑定到具体目标,而不是依赖编译器默认值。下面的工程要求 app 使用 C11,并禁止退回到更旧的标准。
cmake_minimum_required(VERSION 3.20)
project(c_standard_demo LANGUAGES C)
add_executable(app main.c)
set_target_properties(app PROPERTIES
C_STANDARD 11
C_STANDARD_REQUIRED YES
C_EXTENSIONS NO
)C_STANDARD 11 表示目标请求 C11;C_STANDARD_REQUIRED YES 要求编译器不能在不支持时静默降级;C_EXTENSIONS NO 则尽量选择严格标准模式,例如 GCC 常见的 -std=c11,而不是带 GNU 扩展的 -std=gnu11。
如果项目中多个目标都遵循同一标准,也可以在创建目标前设置 CMAKE_C_STANDARD、CMAKE_C_STANDARD_REQUIRED 和 CMAKE_C_EXTENSIONS 作为后续目标的默认值。但单独设置目标属性更便于大型工程逐步迁移。
用一个 C11 特性做验证
下面的 main.c 使用 C11 的 _Static_assert。如果编译器和 CMake 配置满足要求,程序可以正常构建并运行。
#include <stdio.h>
int main(void) {
_Static_assert(sizeof(int) >= 2, "int is unexpectedly small");
puts("C11 build succeeded");
return 0;
}在 Linux 或 macOS 的 Bash 中,可以配置、构建并执行:
cmake -S . -B build >/dev/null
cmake --build build >/dev/null
./build/app预期输出:
C11 build succeededWindows 使用 Visual Studio 等多配置生成器时,可执行文件通常位于 build/Debug/ 或其他配置目录,实际路径应以生成器为准。
为什么不要只写编译器参数
直接给 GCC 写 -std=c11 虽然能工作,但会把工程绑到某一类命令行参数上。CMake 的标准属性会根据当前编译器选择合适的实现方式,避免在工程里硬编码某一种编译器的 -std= 参数。
如果某个目标需要更新标准,例如改为 C17,只需修改 C_STANDARD 17。当编译器确实不支持所需标准时,配置或构建应明确失败,而不是悄悄使用旧模式,这正是可重复构建需要的行为。