C语言Makefile如何将环境变量编译嵌入可执行文件

核心思路是利用C编译器的预处理器宏定义参数，在编译命令行中直接把Makefile获取到的Shell变量/命令输出作为宏常量传入源码，最终常量值会直接固化到生成的二进制文件中，程序运行时可直接读取，不需要额外的运行时IO或环境变量依赖。

第一步：修改Makefile #

原示例存在三个典型问题：

• 直接写BUILD_TIME=$(date)不会执行date命令，Makefile中捕获Shell命令输出需要使用内置的$(shell 命令)语法
• 编译指令没有把变量传递给C预处理器，需要通过gcc的-D参数定义编译期宏
• 带空格的字符串值需要正确转义，否则C预处理器会把空格识别为语法分隔符触发编译错误

修改后的完整Makefile如下：

CC=gcc
# 执行date命令获取当前编译时间，捕获输出赋值给变量
BUILD_TIME=$(shell date)
# 通过-D参数向C代码传入宏，注意双引号的两层转义
CFLAGS=-DBUILD_TIME="\"$(BUILD_TIME)\""

example: example.c
	$(CC) $(CFLAGS) -o example example.c

注意：-D参数后的转义格式不能省略：内层的\"会先被Makefile解析为普通双引号，最终传给gcc的参数为-DBUILD_TIME="Wed Oct 11 14:30:00 CST 2024"，C预处理器会正确将其识别为字符串常量。如果省略转义，带空格的时间字符串会被拆分为多个语法标记，直接报编译错误。

第二步：修改C程序代码 #

编译时传入的BUILD_TIME是全局可见的预处理器宏，源码中不需要额外声明，直接引用即可。同时修正原示例中不符合C标准的main函数写法：

#include <stdio.h>
#define variable 2

int main(){
    printf("Variable: %d\n", variable);
    // 直接访问编译期传入的BUILD_TIME宏
    printf("Binary build time: %s\n", BUILD_TIME);
    return 0;
}

扩展说明 #

• 该方案支持传入任意自定义编译期变量：比如嵌入Git提交哈希、构建版本号、编译主机名等，只需要在Makefile中用$(shell 命令)捕获对应值，再按相同格式通过-D参数传入即可，例如嵌入Git短哈希：

  GIT_HASH=$(shell git rev-parse --short HEAD)
  CFLAGS += -DGIT_HASH="\"$(GIT_HASH)\""
  

• 如果仅需要获取编译时间，也可以直接使用C标准定义的内置宏__DATE__（编译日期，格式为Mmm dd yyyy）和__TIME__（编译时间，格式为hh:mm:ss），不需要额外在Makefile中传值。
• 由于宏值是编译阶段直接写入二进制的常量，程序运行时不会随系统时间变化，完全满足构建溯源的需求。如果担心增量编译时目标文件未重新编译导致构建时间不准，可以在编译前先执行make clean删除旧的目标文件。

内容的提问来源于stack exchange，提问作者KyleG