本文介绍在 Subversion 管理的项目中，如何专业、可靠地将仓库级修订号与提交时间嵌入应用程序（如显示在“关于”页面），避免依赖不稳定的文件级 $Rev$ 关键字，并推荐基于 svn info 和 SubWCRev 的自动化方案。
本文介绍在 subversion 管理的项目中，如何专业、可靠地将仓库级修订号与提交时间嵌入应用程序（如显示在“关于”页面），避免依赖不稳定的文件级 `$rev$` 关键字，并推荐基于 `svn info` 和 `subwcrev` 的自动化方案。
在 Subversion（SVN）项目中，直接使用 $Rev$、$Date$ 等文件级关键字看似便捷，实则存在严重缺陷：这些关键字仅反映该文件最后一次提交的修订信息，而非整个工作副本（Working Copy）或项目的最新状态。当多个文件分散提交时，不同模块可能报告不一致的修订号，导致“关于”页面显示的版本信息失真，违背可追溯性原则。
✅ 推荐方案一：使用 svn info 获取仓库级元数据（跨平台、无依赖）
svn info 命令可精确获取当前工作副本（或指定 URL）的权威修订信息，支持纯 SVN 环境，无需额外工具：
# 获取当前工作副本的最新修订号（HEAD revision of WC） svn info --show-item revision # 获取最后修改时间（ISO8601 格式，含时区） svn info --show-item last-changed-date # 获取完整结构化信息（推荐用于脚本解析） svn info --xml
在构建流程中，可将其集成至编译前步骤。例如，在 CMake 中生成版本头文件：
# CMakeLists.txt 片段 execute_process( COMMAND svn info --show-item revision OUTPUT_VARIABLE SVN_REVISION OUTPUT_STRIP_TRAILING_WHITESPACE ) execute_process( COMMAND svn info --show-item last-changed-date OUTPUT_VARIABLE SVN_DATE OUTPUT_STRIP_TRAILING_WHITESPACE ) configure_file(version.h.in version.h @ONLY)
对应 version.h.in：
#define APP_SVN_REVISION @SVN_REVISION@ #define APP_SVN_DATE "@SVN_DATE@"
这样，所有模块共享同一份权威版本数据，彻底规避文件粒度不一致问题。
✅ 推荐方案二：使用 SubWCRev（Windows/TortoiseSVN 环境首选）
若开发环境已部署 TortoiseSVN，SubWCRev 是专为此类场景设计的成熟工具。它能自动提取工作副本的最高修订号、URL、是否已修改、最后提交时间等，并支持模板替换：
:: 示例：从模板生成版本文件 SubWCRev.exe . version.tmpl version.h
version.tmpl 内容示例：
#define APP_VERSION_MAJOR 2 #define APP_VERSION_MINOR 5 #define APP_VERSION_PATCH 0 #define APP_SVN_REVISION $WCREV$ #define APP_SVN_MODIFIED $WCMODS?Modified:Clean$ #define APP_SVN_DATE "$WCDATE$" #define APP_SVN_URL "$WCURL$"
SubWCRev 会智能计算整个工作副本的最高修订号（即 HEAD），并支持条件宏（如 $WCMODS?...$ 判断是否有未提交变更），非常适合 CI/CD 或手动构建流程。
⚠️ 关于日期关键字的说明
SVN 原生支持多种时间相关关键字：
- $Date$：格式为 2024-05-20 14:32:11 +0800 (Mon, 20 May 2024)
- $Id$：包含路径、修订号、日期、作者（如 $Id: file.c 1843 2024-05-20 06:32:11Z dev $）
- 自定义关键字（SVN 1.8+）：可通过 svn:keywords 属性扩展，例如定义 $BuildTime$ 并配合钩子注入构建时时间。
但请注意：所有文件级关键字均无法保证反映项目整体状态，且 $Date$ 仅记录该文件最后一次提交时间，非当前工作副本最新提交时间。因此，生产环境应始终优先采用 svn info 或 SubWCRev 等仓库级查询方式。
✅ 最佳实践总结
- 杜绝 $Rev$ 等文件级关键字用于应用版本标识——它们是历史遗留陷阱，易引发版本混乱；
- 构建时注入，而非运行时解析：在编译阶段通过脚本生成版本常量，确保信息确定、高效、无运行时开销；
- 区分“构建时间”与“提交时间”：svn info --show-item last-changed-date 返回的是仓库 HEAD 的最后提交时间，而构建时间需由构建系统（如 date +"%Y-%m-%d %H:%M:%S"）单独捕获；
- CI/CD 友好设计：在 Jenkins/GitLab CI 中，可先执行 svn update 再调用 svn info，确保版本信息与实际部署包严格一致。
通过以上方法，您将获得准确、可审计、跨团队一致的应用程序版本标识能力，真正实现“所见即所得”的发布可追溯性。
