如何在Chocolatey nuspec版本中使用10.1.3.10-1545tr103f5d格式并纳入Git提交ID

Chocolatey支持符合SemVer 2.0规范的版本号，你想要的10.1.3.10-1545tr103f5d属于预发布版本格式，通过-分隔主版本号和预发布标识（这里就是Git提交ID相关内容），具体实现方式如下：

1. 直接在nuspec中硬编码版本 #

如果是固定版本场景，直接在nuspec文件的<version>字段填写完整格式即可：

<version>10.1.3.10-1545tr103f5d</version>

注意：预发布部分的字符只能包含字母、数字、-、_、.，不能有空格或其他特殊符号，若Git提交ID存在非法字符，需提前替换或截断。

2. 动态注入Git提交ID（自动化打包推荐） #

手动写死版本号效率低，适合用脚本动态生成包含Git提交ID的版本：

• 用PowerShell获取短提交ID：

$shortCommitId = (git rev-parse --short HEAD)
$fullVersion = "10.1.3.10-$shortCommitId"

• 打包时用--version参数覆盖nuspec中的版本：

choco pack your-package.nuspec --version="$fullVersion"

也可以在nuspec中定义版本变量：

<version>$version$</version>

再在打包时传入完整版本号：

choco pack your-package.nuspec --version="10.1.3.10-1545tr103f5d"

3. 关键注意事项 #

• 版本号必须符合SemVer 2.0规范，否则Chocolatey会拒绝打包或发布。
• 预发布版本在Chocolatey仓库中标记为不稳定版本，默认安装/升级时不会选中，用户需添加--pre参数才能安装。
• 若Git提交ID过长，建议截断为前7-10位，兼顾唯一性和版本号简洁性。

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