.NET Core NuGet包推送时如何指定版本？避免重复冲突

为什么会出现版本重复推送错误？ #

你当前项目的版本号是固定的1.0.0，每次执行dotnet pack都会生成同一版本的NuGet包，而NuGet仓库不允许同一包ID推送重复版本，因此返回409冲突错误。

如何避免重复版本问题？ #

有两种核心解决思路：

1. 推送时跳过重复版本（临时方案） #

在推送命令后添加--skip-duplicate参数，工具会自动跳过已存在的版本，不会抛出错误：

dotnet nuget push MyRepo/MyProject/bin/Release/MyProject.1.0.0.nupkg --api-key ${GET_KEY_FROM_REPO} --source "mygithub" --skip-duplicate

但这只是规避错误，并未解决版本号固定的根本问题，依然会生成重复版本的包。

2. 配置自动版本化（根本方案） #

通过动态生成唯一版本号，让每次打包都生成不同版本的NuGet包，彻底避免重复推送问题。以下是几种常用配置方式：

方式一：手动在.csproj中配置动态版本

编辑项目的.csproj文件，在<PropertyGroup>节点中添加版本相关属性：

• 基于构建编号生成版本：

<PropertyGroup>
  <!-- 基础版本前缀 -->
  <VersionPrefix>1.0</VersionPrefix>
  <!-- 版本后缀，使用构建ID作为唯一标识 -->
  <VersionSuffix>build.$(Build.BuildId)</VersionSuffix>
  <!-- 关闭确定性构建，确保版本号动态生效 -->
  <Deterministic>false</Deterministic>
</PropertyGroup>

打包时，版本号会自动生成为1.0.build.XXX（XXX为当前构建ID）。

• 使用自动递增的修订号：

<PropertyGroup>
  <!-- 主版本.次版本.* 会自动递增修订号 -->
  <Version>1.0.*</Version>
  <Deterministic>false</Deterministic>
</PropertyGroup>

这种方式会基于编译时间自动生成修订号，每次编译都会生成不同的版本。

方式二：使用Git版本控制生成语义化版本

如果你的项目用Git管理，推荐用GitVersion工具基于Git提交、标签自动生成符合语义化规范的版本号：

1. 全局安装GitVersion工具：

dotnet tool install --global GitVersion.Tool

2. 在项目根目录初始化GitVersion配置：

dotnet gitversion init

3. 打包时传入自动生成的版本号：

dotnet pack MyRepo/MyProject/MyProject.csproj -c Release /p:Version=$(dotnet gitversion /showvariable SemVer)

这样版本号会根据Git标签、分支、提交记录自动生成（比如1.0.1-beta.1+abc123），确保每次打包的版本唯一。

VS2022中如何配置自动版本号？ #

可以直接在VS2022的项目属性中配置：

1. 右键项目 → 选择属性
2. 切换到打包选项卡
3. 在版本区域：
   • 设置版本前缀（比如1.0）
   • 勾选在构建时生成版本号，或者手动填写版本后缀（支持内置变量，比如$(Build.BuildId)）
   • 若要使用Git自动版本，可安装GitVersion.VisualStudio扩展，在配置中开启基于Git的版本生成

也可以直接在属性页面点击编辑项目文件，手动添加上述XML配置，效果一致。

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