8、#error与#line指令：编译时错误提示与行号控制

说实话，预处理指令里有两个家伙平时用得不多，但关键时刻真能救命。一个是#error，一个是#line。我刚开始学C语言那会儿，压根没注意过它们，觉得不就是个编译时的报错嘛，有啥好学的？直到后来在一个嵌入式项目里被坑惨了，才老老实实回来补课。

今天咱们就把这两个指令掰开揉碎了讲清楚。它们不复杂，但用好了，能让你的代码质量和调试效率提升一个档次。

8.1 #error：编译时主动“炸”给你看

#error指令的作用很简单——让编译器在预处理阶段直接报错，并输出你指定的错误信息。说白了，就是你在代码里埋了个“地雷”，条件不满足时，编译直接中断。

为什么要这么干？我举个例子你就明白了。

假设你写了一个库，要求目标平台必须是ARM Cortex-M4，而且主频不能低于100MHz。如果用户拿了个M0的芯片去编译，那跑起来肯定出问题。与其让用户运行时一脸懵，不如在编译时就告诉他：“兄弟，你这平台不对，别编译了。”

#ifndef __ARM_ARCH_7EM__
#error "This library requires ARM Cortex-M4 (ARMv7E-M) architecture!"
#endif

#if F_CPU < 100000000
#error "System clock must be at least 100 MHz!"
#endif

你看，这两行#error直接把问题扼杀在编译阶段。用户一编译，终端上就红字报错，清清楚楚。

8.2 #error的常见应用场景

我个人总结下来，#error主要有这么几个用武之地：

• 平台/架构检查：确保代码只在目标硬件上编译
• 配置完整性检查：某些宏必须定义，否则编译不通过
• 版本兼容性检查：编译器版本、标准库版本不满足要求时直接报错
• 功能开关检查：互斥的宏定义同时被开启时，给出明确提示

我曾经在一个项目里遇到过这样的问题：两个不同的模块各自定义了USE_DMA宏，一个表示“使用DMA传输”，另一个表示“使用DMA内存分配”。结果两个宏冲突，程序跑飞了三天才找到原因。后来我加了一段检查：

#if defined(USE_DMA_TRANSMIT) && defined(USE_DMA_ALLOC)
#error "USE_DMA_TRANSMIT and USE_DMA_ALLOC are mutually exclusive!"
#endif

嗯，从那以后，这种低级错误再也没出现过。

8.3 #line：行号控制，调试时的“障眼法”

#line指令的作用是改变编译器对当前行号和文件名的记录。听起来有点玄乎？说白了，就是你可以“骗”编译器，让它以为某段代码来自另一个文件、另一行。

你可能会问：“这有啥用？”

用处大了去了。我举两个场景：

场景一：代码生成器

如果你写过代码生成器（比如从Excel表格自动生成C代码），生成出来的文件往往没有行号对应关系。一旦报错，你根本不知道错误对应原始模板的哪一行。这时候#line就派上用场了：

// 生成器输出示例
#line 1 "template.cfg"
// 这里是根据模板第1行生成的代码
int config_value = 100;

#line 15 "template.cfg"
// 这里是根据模板第15行生成的代码
void init_hardware(void) { ... }

这样，编译器报错时会显示“template.cfg:15”，你一眼就能定位到模板文件的具体位置。

场景二：调试信息美化

有时候你想让调试输出更清晰，比如把某个关键函数的行号重置为1，方便阅读堆栈信息。虽然不常用，但确实有这种需求。

8.4 #line的语法与用法

语法其实很简单，就两种形式：

// 形式1：只改行号
#line 100

// 形式2：同时改行号和文件名
#line 100 "my_custom_file.c"

从#line出现的位置开始，后续代码的行号就从100开始计数，文件名也变成你指定的字符串。直到下一个#line出现，或者文件结束。

来看一个完整的例子：

#include <stdio.h>

int main(void) {
    printf("当前行号: %d\n", __LINE__);  // 输出 5
    
#line 200 "test_section.c"
    printf("当前行号: %d\n", __LINE__);  // 输出 200
    printf("当前文件: %s\n", __FILE__);  // 输出 test_section.c
    
#line 1
    printf("行号重置: %d\n", __LINE__);  // 输出 1
    
    return 0;
}

运行结果：

当前行号: 5
当前行号: 200
当前文件: test_section.c
行号重置: 1

你看，行号和文件名完全被“篡改”了。这在某些场景下非常有用，但用的时候一定要小心，别把自己搞晕了。

8.5 调试辅助技巧：组合使用

说实话，#error和#line单独用已经很实用了，但把它们组合起来，能玩出更多花样。

比如，你可以用#line配合#error，在代码生成器中精确指出错误位置：

#line 42 "config_table.xlsx"
#ifndef MAX_BUFFER_SIZE
#error "MAX_BUFFER_SIZE not defined! Check cell B3 in config_table.xlsx"
#endif

这样，用户看到错误信息时，不仅知道哪个文件哪一行，还能直接去Excel表格里找对应的单元格。我在做自动化配置工具时就是这么干的，团队里的硬件工程师都说好。

8.6 知识体系总览

下面这张图把本章的核心内容串起来了，你可以对照着回顾一下：

8.7 避坑指南

最后，我把自己踩过的坑和总结的经验列出来，你写代码时多留个心眼：

• #error信息要写清楚：别只写个“Error”，要说明为什么错、怎么改。比如#error "Please define USE_FPU to 0 or 1 before including this header"。
• 别滥用#error：有些情况用#warning（非标准，但很多编译器支持）更合适，比如“这个功能已废弃，建议迁移到新API”。
• #line慎用：除非你在写代码生成器或做特殊调试，否则别碰#line。它会让调试信息变得混乱，队友会骂你的。
• 注意作用域：#line从出现位置开始生效，直到文件结束或下一个#line。如果你在头文件里用了#line，记得在头文件末尾恢复，否则会影响包含它的源文件。
• 测试你的#error：我见过有人写了#error，但条件写反了，结果正常情况报错，异常情况反而通过。写完后一定要用不同的配置编译测试一下。

好了，关于#error和#line就讲这么多。这两个指令虽然简单，但在合适的场景下能发挥大作用。下次写代码时，不妨想想能不能用它们提前发现错误、提升调试效率。

公众号:蓝海资料掘金营，微信deep3321