最可靠方式是编译时通过预处理器注入 Git Hash，即用 CMake 的 execute_process 获取 git rev-parse --short=8 HEAD 结果并定义为宏 GIT_COMMIT_HASH，避免运行时依赖 git。
编译时通过预处理器注入 Git Hash
最可靠的方式不是运行时调用 git 命令，而是编译时把 git rev-parse HEAD 的结果作为宏传入。这样避免了程序启动时依赖 git 可执行文件、工作目录是否为 Git 仓库、权限等问题。
常见错误是直接在 C++ 源码里写 std::system("git rev-parse HEAD") —— 这在容器、CI 环境或无 Git 的部署包里必然失败。
- 用 CMake 时，在
CMakeLists.txt中添加：
execute_process(
COMMAND git rev-parse --short=8 HEAD
WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
OUTPUT_VARIABLE GIT_COMMIT_HASH
OUTPUT_STRIP_TRAILING_WHITESPACE
)
add_compile_definitions(GIT_COMMIT_HASH="${GIT_COMMIT_HASH}")
- 在 C++ 代码中直接使用：
std::cout - 注意：如果工作目录没初始化 Git 或处于分离 HEAD 状态，
git rev-parse会报错；建议加RESULT_VARIABLE判断并 fallback 到占位符（如"unknown"）
运行时安全读取 .git/HEAD 和对象文件
如果必须运行时获取（比如热更新场景），不要调用 shell 命令，而是解析 .git 目录结构。Git 的 HEAD 文件内容可能是 ref: refs/heads/main 或直接是 commit hash（分离 HEAD 时）。
- 先读
.git/HEAD，若以ref:开头，则按路径拼出引用文件（如.git/refs/heads/main），再读该文件内容 - 若
.git/HEAD是 40 字符 hex 字符串，则它就是 commit hash（需校验长度和字符集） - 注意 Windows 路径分隔符、
.git可能是文件（git worktree 或 submodule 场景）、以及core.bare=true时.git是纯配置目录
为什么不能用 std::system("git...") 简单粗暴？
看似一行解决，实则埋下多个运行时故障点：
立即学习“C++免费学习笔记（深入）”；
-
git不在$PATH中（Alpine Linux 默认不装 git，Docker 镜像常精简掉） - 当前进程工作目录不是 Git 仓库根目录（
std::system启动的子进程 cwd 不一定可控） - 输出含换行或 ANSI 控制符（
git rev-parse默认带换行，需OUTPUT_STRIP_TRAILING_WHITESPACE或手动 trim） - 权限问题：某些沙箱环境禁止 fork/exec，或 SELinux 策略拦截
CMake + 静态库场景下的 Hash 更新失效问题
当 Git hash 作为宏定义进静态库（libfoo.a），而主程序多次编译但未重新链接该库，就会显示旧 hash —— 因为静态库对象文件没重编译。
- 解决方案：在 CMake 中对生成 hash 的命令加
ADD_DEPENDENCIES，绑定到对应 target - 更稳妥的做法：把 hash 写入一个自动生成的头文件（如
git_hash.h），并在add_library前用configure_file刷新它，确保每次源变更都触发重编译 - 容易被忽略的是：CI 构建时若用
git clone --depth=1，git rev-parse HEAD仍有效，但git describe会失败 —— 所以别混用两种方式
