搭建或规范化 .NET 解决方案时：用 .slnx…

为多项目 .NET 解决方案建立现代化目录结构、统一构建属性、集中 NuGet 版本管理、SDK 固定与 SourceLink 调试支持。

适用场景

解决思路

1. 按推荐布局组织仓库：根目录放 .config/dotnet-tools.json、.editorconfig、.gitignore、global.json、nuget.config、Directory.Build.props、Directory.Build.targets、Directory.Packages.props 和 MyApp.slnx；分离 src/ 与 tests/ 目录；按关注点一项目一职责（Core/Domain、Infrastructure、API/Host）；解决方案文件放在仓库根，所有共享构建配置也放在仓库根。
2. 优先使用 .slnx（XML）解决方案格式：可读、diff 友好、合并冲突少，需要 .NET 9+ SDK 或 Visual Studio 17.13+。结构上用 <Folder Name="/build/"> 收纳 Directory.Build.props、Directory.Packages.props、global.json、NuGet.Config 等文件，用 /src/ 与 /tests/ 分组 <Project Path="..." />。
3. 从 .sln 迁移到 .slnx 执行 `dotnet sln MySolution.sln migrate`；注意不要在同一仓库同时保留 .sln 和 .slnx 文件。
4. 新建 .slnx 解决方案：.NET 10+ 直接 `dotnet new sln --name MySolution`；.NET 9 用 `dotnet new sln --name MySolution --format slnx`；再用 `dotnet sln add src/MyApp/MyApp.csproj` 添加项目。
5. 在根 Directory.Build.props 中集中配置包元数据：Authors、Company、Copyright（可用 $([System.DateTime]::Now.Year) 动态年份）、Product、PackageProjectUrl、RepositoryUrl、PackageLicenseExpression。
6. 在同一文件中集中配置 C# 语言设置：LangVersion=latest、Nullable=enable、ImplicitUsings=enable、TreatWarningsAsErrors=true、EnforceCodeStyleInBuild=true、AnalysisLevel=latest-all、NoWarn 追加 CS1591。
7. 用属性定义目标框架变量以便各项目复用：NetStandardLibVersion=netstandard2.0、NetLibVersion=net8.0、NetTestVersion=net9.0。
8. 配置 SourceLink 相关属性：PublishRepositoryUrl=true、EmbedUntrackSources=true、IncludeSymbols=true、SymbolPackageFormat=snupkg、DebugType=embedded、ContinuousIntegrationBuild 在 '$(CI)'=='true' 时设为 true，并添加 <PackageReference Include="Microsoft.SourceLink.GitHub" PrivateAssets="All" />。
9. 把 NuGet 包资产纳入打包：<None Include="$(MSBuildThisFileDirectory)logo.png" Pack="true" PackagePath="\" /> 与 README.md 同理，并设置 PackageIcon=logo.png、PackageReadmeFile=README.md。
10. 在 Directory.Build.props 中用 <Using Include="..." /> 声明全局 using，例如 System.Collections.Immutable。
11. 嵌套的 Directory.Build.props 不会自动导入外层文件，内层文件必须显式写 <Import Project="$([MSBuild]::GetPathOfFileAbove('Directory.Build.props', '$(MSBuildThisFileDirectory)../'))" /> 再追加自身设置。
12. 在 Directory.Build.targets 中放项目评估之后才生效的内容：共享 analyzer 包引用（如 Meziantou.Analyzer、Microsoft.CodeAnalysis.BannedApiAnalyzers，均 PrivateAssets="all"）、自定义 build target、基于项目类型的条件逻辑。
13. 用根目录 Directory.Packages.props 实现集中包版本管理：设置 ManagePackageVersionsCentrally=true、CentralPackageTransitivePinningEnabled=true。
14. 在 Directory.Packages.props 中把版本抽成属性（如 AkkaVersion、AspireVersion）供多个 PackageVersion 复用，并按 Label 分组（App Dependencies、Test Dependencies、Build Dependencies）列出 <PackageVersion Include=... Version=... />。
15. 在 .csproj 中引用包时不写 Version：只写 <PackageReference Include="Akka" />；个别包需要覆盖时用 <PackageReference Include="Newtonsoft.Json" VersionOverride="13.0.3" />。
16. 在仓库根放 .editorconfig 并设 root=true：通用项如 indent_style=space、indent_size=4、end_of_line=lf、charset=utf-8、trim_trailing_whitespace=true、insert_final_newline=true；csproj/props/targets/xml/json/yml/yaml 用 indent_size=2；C# 项包括 file_scoped 命名空间、prefer_braces、require_accessibility_modifiers=always、using 指令放在命名空间外、System 指令排在最前，以及私有字段 _camelCase 命名规则（severity=warning）。
17. 用 global.json 固定 SDK 版本，例如 {"sdk":{"version":"9.0.200","rollForward":"latestFeature"}}；rollForward 策略可选 disable、patch、feature、latestFeature、minor、latestMinor、major，推荐 latestFeature（同一 feature band 内允许补丁更新）。
18. 用 nuget.config 收紧包来源：设置 disableSourceControlIntegration=true，<clear /> 后显式声明 nuget.org，并用 <packageSourceMapping> 把 pattern 映射到来源，以防供应链攻击；接入私有 feed 时同样为内网源配置专属 pattern（如 MyCompany.*）。
19. 启用 NuGet Audit：在 .NET 9+ 上显式设置 NuGetAudit=true、NuGetAuditLevel=low、NuGetAuditMode=all。
20. 用锁文件保证可复现还原：设置 RestorePackagesWithLockFile=true，CI 中执行 `dotnet restore --locked-mode`。
21. 对发布到 NuGet 的库启用 SourceLink 与确定性构建：PublishRepositoryUrl、EmbedUntrackSources、DebugType=embedded、CI 下 ContinuousIntegrationBuild，并引用 Microsoft.SourceLink.GitHub（PrivateAssets="all"）。
22. 用 RELEASE_NOTES.md 管理版本历史（`#### 1.2.0 January 15th 2025 ####` 加条目列表），并在 CI 中先运行 `./build.ps1`（pwsh）从发布说明更新版本，再 `dotnet build -c Release`，最后用 `dotnet pack -c Release /p:PackageVersion=${{ github.ref_name }}` 按 tag 打包。

适用边界 · 注意事项

• 仍在 .NET 8 或更早 SDK / 旧版 Visual Studio 上开发时，无法使用 .slnx 格式，需继续用 .sln。
• 仓库同时保留 .sln 与 .slnx 会造成混淆与冲突，迁移后应删除旧的 .sln。
• 只有单个项目、不发布 NuGet 包的小型仓库，无需引入 SourceLink、集中包管理与锁文件等重型配置。