18.5K ·GitHub
这是什么？
一个 ASP.NET Core 解决方案模板，为你提供一个经过验证的整洁架构（Clean Architecture）起点——一种松耦合、依赖反转的项目布局，也被称为六边形架构、端口与适配器架构或洋葱架构。
一个 ASP.NET Core 解决方案模板，为你提供一个经过验证的整洁架构（Clean Architecture）起点——一种松耦合、依赖反转的项目布局，也被称为六边形架构、端口与适配器架构或洋葱架构。它是能加到我项目里的框架或库吗？都不是——它是一个 dotnet CLI 项目模板。安装之后，它会生成一套完整的 ASP.NET Core 解决方案（包含 Core、Use Cases、Infrastructure 和 Web 项目，以及测试项目），你可以在里面构建自己的应用。
都不是——它是一个 dotnet CLI 项目模板。安装之后，它会生成一套完整的 ASP.NET Core 解决方案（包含 Core、Use Cases、Infrastructure 和 Web 项目，以及测试项目），你可以在里面构建自己的应用。怎么用它开始一个项目？先用 dotnet CLI 安装模板（dotnet new install Ardalis.CleanArchitecture.Template），然后用 dotnet new clean-arch 生成完整版解决方案，或者用 dotnet new min-clean 生成精简版。其余步骤可以参考官方文档的 Getting Started 部分。
先用 dotnet CLI 安装模板（dotnet new install Ardalis.CleanArchitecture.Template），然后用 dotnet new clean-arch 生成完整版解决方案，或者用 dotnet new min-clean 生成精简版。其余步骤可以参考官方文档的 Getting Started 部分。我需要先装特定版本的 .NET 吗？是的——需要 .NET SDK。README 里说明 main 分支现在使用 .NET 9，对应 NuGet 包版本 10.x，早期环境可以使用旧版本的模板。
是的——需要 .NET SDK。README 里说明 main 分支现在使用 .NET 9，对应 NuGet 包版本 10.x，早期环境可以使用旧版本的模板。安装配置上有什么要注意的坑吗？生成的网站通过 HTTPS 运行，需要 localhost 使用自签名的开发者证书，这在 Chrome 中可能报错——README 里附有解决方法的链接。
生成的网站通过 HTTPS 运行，需要 localhost 使用自签名的开发者证书，这在 Chrome 中可能报错——README 里附有解决方法的链接。它会不会把我绑死在 Windows 和 Visual Studio 上？不会——一切操作都通过跨平台的 dotnet CLI 完成，而且这个仓库的 CI 会运行跨平台的构建和测试流程，所以 Linux 和 macOS 也完全没问题。
不会——一切操作都通过跨平台的 dotnet CLI 完成，而且这个仓库的 CI 会运行跨平台的构建和测试流程，所以 Linux 和 macOS 也完全没问题。完整版模板和精简版模板有什么区别？clean-arch 是包含所有项目和模式的完整解决方案，而 min-clean 是精简变体，需要删掉的样板代码更少。README 中的 Template Comparison 部分（Which Template Should I Use?）可以帮你做选择。
clean-arch 是包含所有项目和模式的完整解决方案，而 min-clean 是精简变体，需要删掉的样板代码更少。README 中的 Template Comparison 部分（Which Template Should I Use?）可以帮你做选择。我只能用 Minimal API 吗，还是也可以用 Controllers 和 Razor Pages？这个模板偏向通过 Ardalis.ApiEndpoints 包来使用 API 端点，但如果你更喜欢 Controllers 或 Razor Pages，README 里也写了如何添加它们。
这个模板偏向通过 Ardalis.ApiEndpoints 包来使用 API 端点，但如果你更喜欢 Controllers 或 Razor Pages，README 里也写了如何添加它们。它是不是偏向领域驱动设计（DDD）？确实有这个倾向：领域事件（Domain Events）是文档中列出的模式之一，同样的架构也是 Steve Smith 和 Julie Lerman 的 NimblePros DDD Fundamentals 课程的基础。不过整洁架构本身是一个更宽泛的松耦合理念，并不专指 DDD。
确实有这个倾向：领域事件（Domain Events）是文档中列出的模式之一，同样的架构也是 Steve Smith 和 Julie Lerman 的 NimblePros DDD Fundamentals 课程的基础。不过整洁架构本身是一个更宽泛的松耦合理念，并不专指 DDD。我用的是较旧的模板版本——升级麻烦吗？不算麻烦：官方文档站提供了在不同版本之间迁移的 Migration Guides，README 也建议升级前先看一看。
不算麻烦：官方文档站提供了在不同版本之间迁移的 Migration Guides，README 也建议升级前先看一看。What are similar projects?aspnetboilerplate, modular-monolith-with-ddd, eShopOnWeb, CleanArchitecture, AspNetCore-Developer-Roadmap, domain-driven-hexagon, practical-aspnetcore, COLA
aspnetboilerplate, modular-monolith-with-ddd, eShopOnWeb, CleanArchitecture, AspNetCore-Developer-Roadmap, domain-driven-hexagon, practical-aspnetcore, COLAWhich topics is it in?domain-driven-design, asp-net-core, entity-framework, aspnet-core, ddd, clean-architecture, unit-testing, template, architecture, best-practices, dotnet, c#
domain-driven-design, asp-net-core, entity-framework, aspnet-core, ddd, clean-architecture, unit-testing, template, architecture, best-practices, dotnet, c#