中央包管理需满足三大前提：项目必须为SDK风格（含Sdk="Microsoft.NET.Sdk"）、Directory.Packages.props须置于解决方案根目录且命名严格匹配、所有PackageReference不得含Version属性，否则被静默忽略。
中央包管理不是“开启开关就能用”的功能，它需要显式声明 Directory.Packages.props 文件，并且所有项目必须使用 SDK 风格的 .csproj（即含 Sdk="Microsoft.NET.Sdk" 的项目格式），否则 ManagePackageVersionsCentrally 会被静默忽略。
如何确认项目支持中央包管理
SDK 风格项目是硬性前提。打开任意 .csproj，检查第一行是否类似：
<Project Sdk="Microsoft.NET.Sdk">
如果不是（例如含 <Project ToolsVersion="15.0"> 或无 Sdk= 属性），则无法启用中央包管理——即使你加了 Directory.Packages.props，MSBuild 也不会加载它。
- 旧式项目（如 .NET Framework 4.7.2 的 Class Library）需先迁移到
Microsoft.NET.Sdk格式，不能只改<TargetFramework> - Visual Studio 中新建项目时，选“Class Library (.NET Standard)”或“Class Library (.NET 6+)”默认就是 SDK 风格；但“Class Library (.NET Framework)”不是
- 执行
dotnet --list-sdks确保有 .NET 6+ SDK（中央包管理自 .NET 6 引入，.NET 5 不支持）
Directory.Packages.props 必须放在正确路径
MSBuild 向上查找该文件，但**不会跨盘符或符号链接**。常见错误是把它放在子目录（如 src/Directory.Packages.props），结果项目在 src/web/MyApp.csproj 就找不到。
- 推荐位置：解决方案根目录（与
.sln同级），例如C:\MyRepo\Directory.Packages.props - 如果项目路径为
C:\MyRepo\src\api\WebApi.csproj，MSBuild 会依次查找：src\api\→src\→C:\MyRepo\→ 停止（找到即用） - 文件名必须**严格为
Directory.Packages.props**，大小写敏感，不能是directory.packages.props或Directory.Packages.xml
为什么 dotnet restore 没报错但版本没生效
最常被忽略的是：项目文件中仍保留了 Version 属性。中央包管理要求 <PackageReference> **完全不带 Version**，否则 MSBuild 会优先采用项目内声明的版本，直接跳过中央清单。
错误写法（版本被覆盖）：
<PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
正确写法（交给中央管理）：
<PackageReference Include="Newtonsoft.Json" />
- 运行
dotnet restore后，检查obj/project.assets.json中对应包的version字段，确认是否为Directory.Packages.props里定义的值 - 若某项目需例外版本，必须用
VersionOverride，而非Version：<PackageReference Include="Newtonsoft.Json" VersionOverride="12.0.3" /> -
VersionOverride仅对单个项目生效，不影响其他项目，也不写入中央清单
CI/CD 中容易漏掉的验证点
本地能用不代表 CI 流水线能用。很多构建镜像（如 mcr.microsoft.com/dotnet/sdk:6.0）默认不包含最新 MSBuild 行为，尤其在 Azure DevOps 或 GitHub Actions 中。
- 确保构建代理安装的是 .NET SDK 6.0.400+ 或 7.0.200+（早期 6.0.x 版本存在
Directory.Packages.props加载时机 bug） - 在 pipeline 中显式添加验证步骤：
dotnet msbuild -pp:out.xml，然后 grepPackageVersion确认是否注入成功 - 不要依赖 Visual Studio 的“还原”按钮——CI 只跑
dotnet restore，而 VS 有时会缓存评估结果导致假象
真正卡住人的往往不是配置语法，而是项目格式、文件路径、版本属性残留这三处细节。一旦其中任一条件不满足，中央包管理就会退化成普通引用，且几乎不报错。
