C / C++ / 系统课时

为项目指定 C 语言标准

为项目指定 C 语言标准

同一份 C 代码在不同编译器上可能落入不同默认语言模式,导致某台机器能编译、另一台却报错。CMake 可以把“必须使用哪一版 C 标准”写进目标配置,让标准要求随工程一起进入构建流程。

学习目标

  • 用 CMake 为目标声明 C11 等语言标准要求
  • 理解 C_STANDARD、C_STANDARD_REQUIRED 与 C_EXTENSIONS 的作用
  • 通过实际构建验证标准配置已经生效

把标准要求写到目标上

对于可执行文件或库,优先把语言标准绑定到具体目标,而不是依赖编译器默认值。下面的工程要求 app 使用 C11,并禁止退回到更旧的标准。

cmake
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 配置满足要求,程序可以正常构建并运行。

c
#include <stdio.h>

int main(void) {
    _Static_assert(sizeof(int) >= 2, "int is unexpectedly small");
    puts("C11 build succeeded");
    return 0;
}

在 Linux 或 macOS 的 Bash 中,可以配置、构建并执行:

bash
cmake -S . -B build >/dev/null
cmake --build build >/dev/null
./build/app

预期输出:

text
C11 build succeeded

Windows 使用 Visual Studio 等多配置生成器时,可执行文件通常位于 build/Debug/ 或其他配置目录,实际路径应以生成器为准。

为什么不要只写编译器参数

直接给 GCC 写 -std=c11 虽然能工作,但会把工程绑到某一类命令行参数上。CMake 的标准属性会根据当前编译器选择合适的实现方式,避免在工程里硬编码某一种编译器的 -std= 参数。

如果某个目标需要更新标准,例如改为 C17,只需修改 C_STANDARD 17。当编译器确实不支持所需标准时,配置或构建应明确失败,而不是悄悄使用旧模式,这正是可重复构建需要的行为。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为项目指定 C 语言标准

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通