gcc -E 是生成预处理文件的正确命令，需配合 -o 输出到文件（如 gcc -E main.c -o main.i），-I 指定头文件路径（双引号包含生效），-C 仅保留注释，不解决宏定义或路径问题。
gcc -E 是生成预处理文件的正确命令，不是 gcc -C 或其他变体。很多初学者会误把 -C（保留注释）当成核心选项，其实它只是辅助参数，必须和 -E 搭配使用才有意义。
gcc -E 基本用法必须带 -o 指定输出文件
直接运行 gcc -E main.c 会把结果打印到终端，对调试帮助有限；真正用于分析或后续流程时，必须用 -o 写入文件：
-
gcc -E main.c -o main.i：最简可用形式，.i是约定后缀，表示预处理中间文件 - 不加
-o时输出到 stdout，容易被终端截断或丢失换行，尤其头文件多时不可靠 - 输出文件名无强制要求，但用
.i能被多数编辑器/IDE 识别为 C 预处理结果，语法高亮更准确
包含路径（-I）要按实际 #include "xxx.h" 的查找逻辑写
如果源码里用双引号包含本地头文件（如 #include "config.h"），-I 路径必须覆盖这些头文件所在目录，否则 gcc -E 会报 "config.h": No such file or directory 错误：
-
gcc -E -I./include -I../common main.c -o main.i：多个-I可叠加，顺序影响查找优先级（从左到右） -
-I后路径是相对于当前执行命令的目录，不是源码目录；若在构建目录中运行，需用相对路径指向源码树中的头文件位置 - 系统头文件（
#include <stdio.h></stdio.h>）不需要显式-I，GCC 自带标准路径；但自定义路径只对双引号包含生效
-C 选项只在需要保留注释时才加
-C 的作用是“在宏展开和头文件插入过程中保留源码里的注释”，默认情况下 gcc -E 会删掉所有注释——这通常是你想要的（干净的展开结果），但某些场景下需要注释辅助定位问题：
-
gcc -E -C main.c -o main.i：保留//和/* */注释，方便对照原始代码检查宏展开位置 - 加了
-C后，预处理输出体积明显增大，尤其含大量文档注释时；非调试阶段建议省略 -
-C不影响头文件搜索或宏行为，只是输出控制开关，和-I、-D等无关
CMake 中调用 gcc -E 容易漏掉绝对路径和并发冲突
在 CMake 脚本里用 execute_process 调 gcc -E 时，常见坑不在命令本身，而在路径和并行构建：
- 源文件路径必须是绝对路径，否则
gcc在构建目录里找不到#include "xxx.h"；要用get_filename_component(... ABSOLUTE)转换 - 多个源文件同时生成
.i文件时，若都写进同一个目录且不区分文件名，会相互覆盖；推荐用${CMAKE_CURRENT_BINARY_DIR}/pre_files/${only_file_name}.i隔离 - CMake 默认允许多目标并发执行，但若多个
execute_process写同一临时 shell 脚本（如__pre.sh），可能因文件竞态失败；应确保脚本路径唯一或改用内联命令
真正卡住人的往往不是 gcc -E 语法本身，而是头文件路径没对上、输出被覆盖、或者以为 -C 能解决宏定义失效这类根本性问题——它只管注释，不管逻辑。
