如何通过CMake与GCC为ELF二进制添加命令行版本选项

最小源码改动实现-v输出版本 #

现有代码已经有现成的APP_VERSION宏，完全不需要引入复杂的第三方命令行解析库，几行代码就能搞定需求，对原有逻辑几乎零侵入：

• 找到程序入口main函数，直接在函数最开头加参数遍历逻辑就行——C/C++的main函数默认就带argc（参数计数）、argv（参数数组）两个入参，之前没做参数处理不代表这两个参数不能用。
• 因为只需要处理-v/--version这一个参数，连标准库参数解析组件都不用上，手写判断就行。如果用C风格写法，记得在文件头补#include <cstdio>和#include <cstring>两个头文件，参考代码如下：

int main(int argc, char* argv[]) {
    // 新增的版本判断逻辑，放在原有业务代码最前面
    for (int i = 1; i < argc; ++i) {
        const char* arg = argv[i];
        if ((strcmp(arg, "-v") == 0) || (strcmp(arg, "--version") == 0)) {
            printf("%s version: %s\n", argv[0], APP_VERSION);
            return 0;
        }
    }

    // 以下是原有全部业务代码，*完全不需要改动*
    // ...
}

• 只要保证main所在的编译单元能include到定义APP_VERSION的头文件就行，改完重新编译，直接跑ex_app -v就能输出版本，新增代码总共不到10行，无任何额外依赖。如果后续要加更多命令行参数，再考虑换argp、cxxopts这类轻量解析库也不迟。

GCC 向ELF二进制内嵌版本信息的方法 #

GCC确实支持不依赖源码运行逻辑，直接把版本信息烙进ELF文件里，常用两种方式：

• 编译阶段注入宏定义：不需要把版本号硬写在头文件里，编译时直接通过-D参数传宏就行。配合CMake的话可以直接在构建配置里统一管理版本号，不用手动改源码：比如在CMakeLists.txt里声明项目版本project(ex_app VERSION 1.0)，然后加target_compile_definitions(ex_app PRIVATE APP_VERSION="${PROJECT_VERSION}")，构建时会自动把版本号传给源码，连单独的版本头文件都可以省。
• 自定义ELF段存储版本字符串：可以通过GCC的__attribute__((section()))属性，把版本字符串放到ELF的独立只读段里，比如加一行全局定义：

  __attribute__((section(".rodata.app_version"), used))
  const char app_ver_mark[] = "ex_app release version: 1.0";
  

  编译完成后就算不运行程序，直接用readelf -p .rodata.app_version ex_app或者strings ex_app | grep "ex_app release"就能直接读出版本号，不会因为程序逻辑异常导致版本信息拿不到。如果不想改源码，也可以通过链接脚本--version-script参数往ELF的版本段里写入信息，效果一致。

额外提示 #

如果后续要做版本号的自动化维护，完全可以把版本号的更新逻辑放到CI/CD构建流程里，每次打版本tag构建的时候自动更新CMake里的版本号，不需要手动改任何源码文件。
不推荐用LD_PRELOAD劫持、外层套shell脚本这类零源码改法，维护成本比改几行main函数高太多，完全没必要。

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