如何为Visual Studio 2022解决方案的所有项目统一管理版本号？

针对12个DLL项目的版本统一管理，推荐以下几种实用方案：

1. 使用Directory.Build.props共享属性文件 #

这是最直接的原生方案，利用MSBuild的默认继承机制，在解决方案根目录创建一个Directory.Build.props文件，所有项目会自动读取其中的配置。

• 操作步骤：

  1. 在解决方案根目录新建文本文件，重命名为Directory.Build.props
  2. 写入版本相关属性，示例内容：

  <Project>
    <PropertyGroup>
      <!-- 统一版本号 -->
      <Version>1.0.0.0</Version>
      <AssemblyVersion>1.0.0.0</AssemblyVersion>
      <FileVersion>1.0.0.0</FileVersion>
      <!-- 可选：指定版权、公司名等其他共享属性 -->
      <Company>YourCompany</Company>
    </PropertyGroup>
  </Project>
  

  3. 打开每个DLL项目的.csproj文件，删除原有版本相关的<Version>、<AssemblyVersion>等节点（如果存在）
  4. 重新加载解决方案，所有项目会自动使用Directory.Build.props中的版本号，后续只需修改这个文件即可统一更新

• 优势：零额外工具，配置一次永久生效，适合所有项目版本完全统一的场景

2. 使用Visual Studio属性表(.props) #

如果需要部分项目分组管理版本（比如部分项目用同一版本，另一部分用另一个），可以用属性表实现灵活分组。

• 操作步骤：

  1. 在解决方案中添加一个“属性表”项（右键解决方案 → 添加 → 新建项 → 常规 → 属性表）
  2. 打开属性表的“通用属性 → 程序集信息”，设置统一的版本号，或者直接编辑属性表的XML内容添加版本节点
  3. 右键每个需要统一版本的DLL项目 → 属性 → 通用属性 → 导入属性表，选择刚才创建的属性表
  4. 后续更新版本时，直接修改属性表的配置即可同步到所有引用它的项目

• 优势：支持分组管理，比Directory.Build.props更灵活，适合有部分项目版本差异的场景

3. MSBuild命令行参数指定版本 #

适合自动化构建场景，无需修改任何配置文件，直接在构建时通过命令行传入版本号。

• 操作示例：
  打开命令提示符，进入解决方案目录，执行以下命令：

  msbuild YourSolution.sln /p:Version=1.2.3.0 /p:AssemblyVersion=1.2.3.0 /p:FileVersion=1.2.3.0
  

  或者用dotnet CLI：

  dotnet build YourSolution.sln /p:Version=1.2.3.0
  

• 优势：完全无需修改代码或配置，适合CI/CD流水线中动态指定版本的场景

4. 使用GitVersion自动生成版本号 #

如果你的项目用Git管理，GitVersion可以根据Git标签、分支、提交记录自动生成符合语义化的版本号，无需手动维护版本号。

• 操作步骤：

  1. 安装GitVersion工具（通过NuGet或dotnet CLI：dotnet tool install --global GitVersion.Tool）
  2. 在解决方案根目录创建GitVersion.yml配置文件，示例配置：

  mode: Mainline
  branches:
    main:
      regex: ^master$|^main$
      mode: ContinuousDeployment
      tag: ''
      increment: Patch
      prevent-increment-of-merged-branch-version: true
      track-merge-target: false
      tracks-release-branches: false
      is-release-branch: false
  

  3. 在Directory.Build.props中添加以下内容，让项目自动读取GitVersion生成的版本：

  <Project>
    <PropertyGroup>
      <Version>$([GitVersion.SemVer])</Version>
      <AssemblyVersion>$([GitVersion.AssemblySemVer])</AssemblyVersion>
      <FileVersion>$([GitVersion.AssemblySemFileVer])</FileVersion>
    </PropertyGroup>
  </Project>
  

  4. 构建时GitVersion会自动根据Git历史生成版本号，你也可以通过dotnet gitversion命令查看当前生成的版本

• 优势：版本号与Git仓库状态绑定，自动化程度高，适合遵循Git Flow或GitHub Flow的项目

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