Git拉取请求中.csproj文件NuGet包引用重复问题求助

常见原因 #

• 更新工具/命令使用错误：如果用Install-Package而非Update-Package（Package Manager Console），或者CLI命令参数有误，工具会直接新增新版本引用，而非替换旧版本。部分IDE的包管理器在缓存异常时也会出现这类重复添加的情况。
• PR合并冲突处理不当：拉取请求合并过程中，若未正确处理csproj文件的版本冲突，容易导致新旧版本的包引用都被保留。
• 间接引用被误显式写入：少数场景下，目标包的间接依赖被转为显式引用，更新直接引用时，旧的间接引用条目未被清理，造成重复。
• CI/CD脚本逻辑缺陷：自动更新包的脚本如果只执行添加新版本的操作，未同步删除旧版本引用，就会产生重复条目。

解决方案 #

• 手动清理重复条目：直接打开.csproj文件，删除旧版本的<PackageReference>节点，保存后执行dotnet restore重新还原依赖。示例：

  <!-- 保留新版本，删除旧版本 -->
  <PackageReference Include="[package_name]" Version="[new_version]" />
  

• 使用正确的更新命令：
  • Package Manager Console：Update-Package [package_name]
  • .NET CLI：dotnet add package [package_name] --version [new_version]
    这些命令会自动替换现有引用，不会新增重复条目。
• 清理NuGet缓存：执行dotnet nuget locals all --clear清除本地缓存，避免缓存中的旧数据干扰更新逻辑，之后再重新执行包更新操作。
• 检查IDE配置：在Visual Studio中，进入Tools > Options > NuGet Package Manager，确认相关自动恢复选项正常启用，避免工具因缓存或状态异常重复添加引用。
• 修复CI/CD脚本：如果是自动化脚本导致的问题，调整脚本逻辑，确保更新包时先移除旧版本引用（如dotnet remove package [package_name]），再添加新版本。

验证步骤 #

更新完成后，打开.csproj确认仅存在新版本的包引用，执行dotnet build确保项目编译正常，同时运行测试验证功能不受影响。

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