用途:为现代 .NET 项目提供解决方案布局与共享构建配置的参考指南,适用于创建新解决方案、审查现有结构或提出改进建议。使用前需先运行 dotnet-version-detection 确定 TFM 与 SDK 版本,因为部分特性有版本要求(如 .slnx 需 .NET 9+ SDK)。
主要能力:推荐解决方案布局(.sln、src/、tests/ 分离,每个关注点一个项目,解决方案文件置于仓库根目录);.slnx 与 .sln 两种解决方案格式;Directory.Build.props 与 Directory.Build.targets 共享配置;中央包管理(CPM)与锁文件;.editorconfig 与分析器配置;SourceLink、NuGet Audit 与 nuget.config。
必要用法:将 .sln 迁移为 .slnx 使用 dotnet sln MyApp.sln migrate;创建传统解决方案使用 dotnet new sln -n MyApp 与 dotnet sln add;启用锁文件后在 CI 中使用 dotnet restore --locked-mode。CPM 在 Directory.Packages.props 中集中版本,项目文件引用包时不写 Version;个别项目可用 VersionOverride 覆盖,但应在代码审查中标记。nuget.config 建议使用 clear 加显式源与 packageSourceMapping 防止供应链攻击。
适用场景:新建或重构 .NET 解决方案、统一多项目构建配置、管理 NuGet 包版本与安全审计、为发布 NuGet 的库配置 SourceLink 与确定性构建。
限制:构建输出组织(UseArtifactsOutput)与 MSBuild 自定义编写不在范围内,分别参见 dotnet-artifacts-output 与 dotnet-msbuild-authoring。嵌套 Directory.Build.props 不会自动导入外层文件,需手动 Import。.slnx 需要 .NET 9+ SDK 或 Visual Studio 17.13+。资料未提供收费、价格与平台信息。