单参数 static_assert ​

什么是单参数 static_assert ​

static_assert 是 C++11 引入的编译期断言机制,用来在编译阶段检查某个条件是否成立。如果条件为 false,编译器会报错并输出你指定的错误信息。C++11 的语法要求必须提供两个参数:一个布尔常量表达式和一个字符串字面量作为错误消息。

C++17 对此做了一个小改进:允许省略第二个参数(错误消息),只写一个布尔常量表达式就行。编译器在断言失败时会自己生成一条默认的错误提示。

这个改动的动机很实际:很多时候断言条件本身就已经足够表达意图了,比如 static_assert(sizeof(int) == 4) ——条件写得很清楚,再写一条 "int must be 4 bytes" 的消息纯属多余。C++17 之前强制要求写错误消息,导致很多人写的消息就是把条件用自然语言重复一遍,没有额外信息量。

基本语法 ​

cpp
// C++11 语法:两个参数,错误消息是必须的
static_assert(常量表达式, "错误消息字符串");

// C++17 语法:单参数,省略错误消息
static_assert(常量表达式);

两种语法都要求第一个参数是一个能在编译期求值的布尔常量表达式。如果表达式为 true,static_assert 不产生任何效果;如果为 false,编译器报错。

基本示例 ​

cpp
#include <iostream>
#include <type_traits>
#include <cstdint>

// ============================
// 示例1:基本的编译期检查
// ============================

// C++17:直接写条件,不需要消息字符串
static_assert(sizeof(int) >= 4);          // 检查 int 至少是 4 字节
static_assert(sizeof(void*) == 8);        // 检查指针大小(64 位系统)
static_assert(sizeof(char) == 1);         // char 永远是 1 字节(标准保证)

// 对比 C++11 的写法:
// static_assert(sizeof(int) >= 4, "int must be at least 4 bytes");
// 消息字符串 "int must be at least 4 bytes" 其实就是条件的自然语言翻译,没有额外信息

// ============================
// 示例2:配合 type_traits 使用
// ============================

template<typename T>
T safe_add(T a, T b) {
    // 编译期检查:只允许算术类型调用这个函数
    static_assert(std::is_arithmetic_v<T>);

    // 如果需要更具体的消息,还是可以用双参数形式
    static_assert(!std::is_same_v<T, bool>, "safe_add 不适用于 bool 类型");

    return a + b;
}

// ============================
// 示例3:在模板中约束类型
// ============================

template<typename T>
struct NumericContainer {
    // 确保 T 是数字类型
    static_assert(std::is_arithmetic_v<T>);

    // 确保不是 bool
    static_assert(!std::is_same_v<T, bool>);

    T data[100];

    T sum() const {
        T result = 0;
        for (const auto& val : data) {
            result += val;
        }
        return result;
    }
};

// ============================
// 示例4:检查平台特性
// ============================

// 检查 char 是否是有符号的(这在不同平台上可能不同)
// static_assert(std::is_signed_v<char>);  // 在某些 ARM 平台上会失败

// 检查 IEEE 754 浮点数
static_assert(std::numeric_limits<float>::is_iec559);

// 检查字节序相关的假设(通过检查特定的内存布局)
static_assert(sizeof(std::int32_t) == 4);
static_assert(sizeof(std::int64_t) == 8);

// ============================
// 示例5:配合 constexpr 函数
// ============================

constexpr int compute_alignment(int size) {
    // 计算对齐到 2 的幂次的结果
    int align = 1;
    while (align < size) align *= 2;
    return align;
}

// 在编译期验证计算结果
static_assert(compute_alignment(3) == 4);
static_assert(compute_alignment(5) == 8);
static_assert(compute_alignment(16) == 16);

int main() {
    // 函数内部也可以使用 static_assert
    static_assert(sizeof(long long) >= 8);

    auto result = safe_add(10, 20);
    std::cout << "10 + 20 = " << result << std::endl;

    // 下面这行如果取消注释会编译失败:
    // safe_add(std::string("a"), std::string("b"));
    // 错误信息会提示 std::is_arithmetic_v<std::string> 为 false

    NumericContainer<double> container{};
    container.data[0] = 1.5;
    container.data[1] = 2.5;
    std::cout << "前两个元素的和(近似): " << container.data[0] + container.data[1] << std::endl;

    // 下面这行如果取消注释会编译失败:
    // NumericContainer<std::string> bad_container;

    return 0;
}

与旧写法的对比 ​

对比项C++11 static_assertC++17 单参数 static_assert
语法static_assert(expr, "msg");static_assert(expr);
错误消息必须提供可选
编译器报错内容显示你写的消息字符串显示编译器生成的默认消息(通常包含失败的表达式)
适用场景需要自定义错误提示时条件本身已经足够表达意图时
C++26 扩展--支持 static_assert(expr, f(args)) 动态生成消息

适用场景 ​

  • 编译期检查平台假设:比如 int 的大小、指针的大小、字节序等,跨平台代码中很常见
  • 模板参数约束:在 C++20 Concepts 出现之前,static_assert 是约束模板参数的主要手段之一
  • 验证 constexpr 计算结果:确保编译期计算函数的结果符合预期
  • 检查类型特性:配合 <type_traits> 中的各种 trait,在编译期检查类型是否满足某些条件
  • 库开发中的配置检查:确保用户的编译环境满足库的要求

常见问题 ​

单参数 static_assert 失败时,编译器输出什么?

各编译器的输出略有不同,但通常都会包含失败的表达式文本。比如 static_assert(sizeof(int) == 8) 失败时:

  • GCC 输出类似:error: static assertion failed
  • Clang 输出类似:error: static_assert failed due to requirement 'sizeof(int) == 8'
  • MSVC 输出类似:error C2607: static assertion failed

Clang 的输出信息最友好,会直接告诉你是哪个条件不满足。如果你需要给用户更明确的提示(比如在库的公共 API 中),还是建议用双参数形式写上自定义消息。

static_assert 可以放在哪些位置?

几乎任何地方都可以:命名空间作用域、类定义内部、函数体内部、模板定义中。它是一个声明(declaration),不是语句,所以甚至可以放在全局作用域。

static_assert(false) 在模板中的行为是什么?

在 C++23 之前(CWG2518 修复前),static_assert(false) 即使在未实例化的模板中也会导致编译错误,因为编译器在解析阶段就能确定条件为 false。常见的解决方法是用一个依赖于模板参数的 false 值:

cpp
template<class> constexpr bool always_false = false;

template<class T>
void unsupported() {
    static_assert(always_false<T>, "不支持的类型");
    // 只有模板被实例化时才会触发断言
}

C++23 起(P2593R1),static_assert(false) 在未实例化的模板中不再是错误,只有实例化时才会报错。

注意事项 ​

  • 单参数 static_assert 是 C++17 特性,如果你的代码需要兼容 C++11/14,还是得用双参数形式
  • 在公共库的 API 中,建议使用双参数形式并提供清晰的错误消息,方便库的使用者理解问题
  • static_assert 只能检查编译期常量表达式,不能检查运行时的值。运行时断言用 assert() 或 <cassert>
  • C++26 进一步增强了 static_assert,允许第二个参数是常量表达式(不限于字符串字面量),比如可以用 std::format 生成动态的错误消息
  • static_assert 不产生任何运行时代码,零开销

编译器支持情况 ​

编译器最低支持版本
GCC6.0
Clang2.5
MSVC19.10 (VS 2017)

总结 ​

C++17 的单参数 static_assert 是一个很小的改进:允许省略错误消息字符串。改动虽小,但日常使用中确实方便了不少——很多时候断言条件本身已经足够清晰,强制写一条重复条件内容的消息只是增加噪音。在条件本身能说明问题的场景下(比如 static_assert(sizeof(int) == 4)),用单参数形式更简洁;在需要给使用者明确提示的场景下(比如库的公共接口),还是用双参数形式写上有意义的错误消息。static_assert 本身是 C++ 编译期编程的重要工具,配合 type_traits 和 constexpr 函数,能在编译阶段发现大量潜在问题。