C++如何获取当前代码的Git提交版本号-C++-PHP中文网

最可靠方式是在cmake构建阶段用execute_process执行git describe --always --dirty获取版本号，通过configure_file注入version.h头文件，并确保add_dependencies强制每次重建；避免运行时调用git。

c++如何获取当前代码的git提交版本号

编译时通过shell命令注入Git版本号

最可靠的方式不是运行时调用 git 命令（可能没装、路径不对、子模块混乱），而是在构建阶段把版本信息作为预处理器宏或源文件内容写进去。CMake是最常见的载体，它能安全执行 git describe --always --dirty 并生成头文件。

在 CMakeLists.txt 中添加：

execute_process(COMMAND git describe --always --dirty
  WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
  OUTPUT_VARIABLE GIT_VERSION
  OUTPUT_STRIP_TRAILING_WHITESPACE
  ERROR_QUIET)
configure_file("${CMAKE_SOURCE_DIR}/version.h.in" "${CMAKE_BINARY_DIR}/version.h")

准备 version.h.in：
```
#define GIT_VERSION "@GIT_VERSION@"
```
确保编译时包含生成的 version.h 路径：
```
include_directories(${CMAKE_BINARY_DIR})
```

运行时读取嵌入的版本字符串（不推荐但可行）

如果坚持运行时获取，std::system 或 popen 调用 git 是高风险操作：工作目录可能不是项目根目录，git 可能不可用，子进程失败无提示。更稳妥的做法是只在开发/测试环境启用该逻辑，并加 fallback。

用 popen 获取输出（Linux/macOS）：

FILE* fp = popen("git -C /path/to/repo describe --always --dirty 2>/dev/null", "r");

必须显式指定 -C 参数，否则当前工作目录不确定
Windows 下需改用 _popen，且 git 必须在 PATH 中，否则返回空
永远要检查 fp 是否为 nullptr，并限制读取长度防止缓冲区溢出

`git describe` 输出格式与语义差异

git describe 的结果不是固定格式，取决于仓库状态，直接字符串匹配容易出错。常见输出包括：v1.2.3-5-gabc123（距最近 tag 5 次提交）、v1.2.3（正好在 tag 上）、abc123（无 tag）、v1.2.3-dirty（工作区已修改）。这些都需要按需解析。

GitHub Iteration Workflow

GitHub Issue 全流程自动化：自动拉取、修复 Issue，创建 PR，监控 CI/CD，合并部署。

下载

--always 确保即使无 tag 也返回 commit hash，避免命令失败
--dirty 标记工作区是否修改，但不会告诉你哪些文件脏——仅作发布校验用
若需语义化版本，建议配合 git tag -l "v[0-9]*" 和正则提取主版本号，而非硬切分字符串
CI 环境中 git clone 默认是 shallow 的，git describe 可能找不到足够远的 tag；需提前 git fetch --unshallow 或用 --tags

静态链接时版本号“冻结”在二进制里的坑

版本号一旦写进可执行文件，就和构建时刻绑定。如果构建脚本没强制更新，或者缓存了中间产物（如 CMake 的 build/ 目录重用），你拿到的可能是几天前的 commit ID。

在 CMake 中对 version.h.in 添加依赖：

set_property(DIRECTORY PROPERTY INCLUDE_DIRECTORIES ${CMAKE_BINARY_DIR})
add_custom_target(git_version DEPENDS ${CMAKE_BINARY_DIR}/version.h)
add_dependencies(your_target git_version)