基于合并分支生成版本：VSTS中CakeBuild实现NuGet自动语义化版本问题

当然可行！完全不用每次手动修改Nuspec文件，核心思路是通过Git历史记录追踪合并到master的分支类型，再结合CakeBuild动态计算语义化版本号。下面给你一步步讲具体实现：

核心逻辑：识别合并到master的来源分支 #

要判断是hotfix、develop还是其他分支合并到master，我们可以通过Git的合并提交信息来解析——毕竟合并到master的操作都会留下包含来源分支的提交记录（比如默认的Merge branch 'hotfix/v1.2.4' into master）。

在CakeBuild中，你可以调用Git命令来获取这些信息，比如：

string GetMergedSourceBranch()
{
    // 获取master分支最近的1条合并提交信息
    var mergeCommitMsg = GitLog(new GitLogSettings {
        MergesOnly = true,
        Limit = 1,
        PrettyFormat = "%s" // 只取提交标题
    }).FirstOrDefault();

    if (string.IsNullOrEmpty(mergeCommitMsg))
    {
        // 处理直接提交到master的情况，这里可以自定义默认分支类型
        return "direct-master";
    }

    // 解析标准合并信息里的分支名
    var branchMatch = System.Text.RegularExpressions.Regex.Match(mergeCommitMsg, @"Merge branch '([^']+)' into");
    if (branchMatch.Success)
    {
        return branchMatch.Groups[1].Value;
    }

    // 兼容GitHub PR合并的格式（比如"Merge pull request #123 from username/hotfix/xxx"）
    var prMatch = System.Text.RegularExpressions.Regex.Match(mergeCommitMsg, @"from [^/]+/([^ ]+)");
    if (prMatch.Success)
    {
        return prMatch.Groups[1].Value;
    }

    return "unknown";
}

根据分支类型计算语义化版本号 #

拿到来源分支后，就可以按照语义化版本规则（SemVer）来增量版本号了。推荐用SemVer NuGet包来处理版本解析和增量，避免自己写字符串处理逻辑：

1. 先在Cake脚本顶部引入SemVer包：

#addin "nuget:?package=SemVer"

2. 实现版本计算逻辑：

SemVersion GetAutoSemanticVersion()
{
    // 步骤1：获取当前基础版本（推荐从Git标签读取，比如最近的正式版本标签）
    var latestTag = GitDescribe(new GitDescribeSettings {
        Tags = true,
        Abbrev = 0 // 只取标签名，不带哈希后缀
    });
    var currentVersion = SemVersion.Parse(latestTag);

    // 步骤2：获取合并到master的来源分支
    var sourceBranch = GetMergedSourceBranch();

    // 步骤3：根据分支类型增量版本
    SemVersion newVersion;
    if (sourceBranch.StartsWith("hotfix/"))
    {
        // Hotfix分支：增量补丁版本（比如1.2.3 → 1.2.4）
        newVersion = currentVersion.WithPatch(currentVersion.Patch + 1);
    }
    else if (sourceBranch == "develop")
    {
        // Develop分支：增量次要版本（比如1.2.3 → 1.3.0）
        newVersion = currentVersion.WithMinor(currentVersion.Minor + 1).WithPatch(0);
    }
    else if (sourceBranch.StartsWith("release/"))
    {
        // Release分支：准备正式版本，这里可以根据你的流程调整（比如增量次要版本）
        newVersion = currentVersion.WithMinor(currentVersion.Minor + 1).WithPatch(0);
    }
    else
    {
        // 默认情况：比如直接提交到master，默认增量补丁版本
        newVersion = currentVersion.WithPatch(currentVersion.Patch + 1);
    }

    return newVersion;
}

动态生成NuGet包（无需修改Nuspec） #

最后，在Cake的NuGetPack任务中直接使用计算好的版本号，完全不用改动Nuspec文件里的版本字段：

var autoVersion = GetAutoSemanticVersion().ToString();

NuGetPack("./YourPackage.nuspec", new NuGetPackSettings {
    Version = autoVersion,
    OutputDirectory = "./artifacts/nuget"
});

额外注意事项 #

• 分支命名规范：确保你的团队遵循统一的分支命名规则（比如hotfix/*、develop、release/*），这样分支解析逻辑才能可靠工作。
• Git标签管理：每次正式发布后记得打一个版本标签（比如v1.2.3），这样脚本才能准确获取基础版本。
• 本地测试：可以在本地模拟合并场景（比如把hotfix分支合并到master），运行Cake脚本验证版本号是否正确生成。

这样一来，每次合并分支到master触发构建时，Cake都会自动识别分支类型并生成对应的语义化版本号，完全不需要手动修改Nuspec！

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