TeamCity构建的.NET 5.0 NuGet包在Visual Studio中无法正常显示

这个故障和.NET 5停止官方支持没有直接关联，核心原因基本是目标框架修改触发的NuGet兼容性过滤规则，按以下顺序排查即可：

1. 优先排查目标框架兼容性匹配问题 #

net5.0-windows7.0属于Windows平台专属的目标框架变体（TFM），和不带平台后缀的通用net5.0不满足NuGet的默认兼容判定规则：

• 如果你要引用该包的项目目标框架是通用net5.0、非Windows平台的.NET版本、或者低于net5.0的框架版本，NuGet会自动判定你新发布的Windows专属版本不兼容，直接在包列表中隐藏，仅展示此前发布的、框架兼容的旧版本，和你描述的现象完全吻合。
• 验证方式很简单：右键引用项目打开「属性」面板，确认项目的目标框架配置，如果不是带-windows后缀的.NET 5+专属框架，就会触发这个隐藏逻辑。

2. 排除NuGet缓存与源索引异常 #

如果确认框架匹配没有问题，再排查源和本地缓存的问题：

• 打开Visual Studio的NuGet包管理器设置，执行「清除所有NuGet缓存」操作，重启VS后重新刷新包列表，排除本地缓存拉取旧索引导致的版本不显示问题。
• 直接登录你的本地NuGet源存储位置，确认最新版本的.nupkg包文件确实已经成功上传到源目录，没有出现上传中断、文件覆盖失败的问题；如果是自建NuGet服务（比如NuGet.Server、BaGet等），手动触发一次包索引重建，确保源端已经正确识别最新版本。
• 可以在开发机命令行执行 nuget list <你的包名称> -Source <你的本地NuGet源地址> -AllVersions，查看返回的版本列表中是否存在你最新发布的版本，先确认源端本身的版本数据是正确的。

3. 对应修复方案 #

根据你的实际需求选择处理方式即可：

• 如果你确实需要依赖Windows 7特定系统API、使用DevExpress的Windows专属组件，不需要修改现有包的构建配置：把所有要引用该包的项目，目标框架修改为net5.0-windows（或更高版本的Windows专属.NET TFM），重新加载项目后刷新NuGet列表就能看到最新版本。
• 如果你希望该包能被通用.NET 5项目跨平台引用，就把构建配置里的目标框架从net5.0-windows7.0改回通用net5.0，或者在项目文件中配置多目标框架，同时编译通用版本和Windows专属版本，重新打包发布即可。

注意：不要手动修改nuspec文件的依赖配置，把Windows专属包伪装成通用.NET 5包，否则非Windows环境安装后会在运行时抛出Windows API找不到的异常，留下隐性故障。

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