VS for Mac安装NuGet包时版本位置报错，求解决方案

问题根源 #

Ardalis Clean Architecture模板默认启用了Central Package Management (CPM，集中包版本管理)，要求所有包版本统一在解决方案根目录的Directory.Packages.props中维护，项目文件的<PackageReference>不能携带Version属性，否则会触发NuGet的版本冲突报错。

解决方案 #

1. 确认CPM配置
   检查解决方案根目录的Directory.Packages.props，确保存在以下核心配置：

   <PropertyGroup>
     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
   </PropertyGroup>
   

2. 让VS for Mac自动适配CPM安装包

   • 打开NuGet包管理器（右键解决方案→管理NuGet包），安装/更新包时，勾选界面中的**"Central Package Management"**选项，VS会自动将版本写入Directory.Packages.props，而非项目文件。
   • 若没有该选项，先手动在Directory.Packages.props中添加对应包的版本：

     <PackageVersion Include="Your.Package.Name" Version="x.x.x" />
     

     再在项目文件中保留不带版本的引用：

     <PackageReference Include="Your.Package.Name" />
     

     最后执行dotnet restore完成包还原。

3. 批量修复现有报错的项目文件

   • 使用VS for Mac的全局查找替换功能，在解决方案范围内搜索：

     <PackageReference Include="([^"]+)" Version="([^"]+)" />
     

     替换为：

     <PackageReference Include="$1" />
     

     注意排除Directory.Packages.props文件，避免误改。
   • 将所有移除的版本号统一添加到Directory.Packages.props的<PackageVersion>节点中。

4. 实现个别项目的版本差异化
   如果需要某个项目使用与集中管理不同的包版本，在该项目的<PackageReference>中使用VersionOverride属性替代Version：

   <PackageReference Include="Your.Package.Name" VersionOverride="y.y.y" />
   

   这样既兼容CPM模式，又能实现版本差异化，不会触发报错。

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