Repolode
jasontaylordev

jasontaylordev/CleanArchitecture

基于 Clean Architecture 的 ASP.NET Core 解决方案模板,可选 Angular、React 或纯 Web API。

Star
20,651
Fork
4,291
未关闭 Issue
9
最近提交
12小时前

这是什么?

该模板用于生成基于 Clean Architecture 分层结构的 ASP.NET Core 解决方案,将领域、应用、基础设施和 Web 层分开组织。使用 dotnet CLI 创建时,可以选择前端框架(Angular、React,或不带前端的纯 API)和数据库(默认 SQLite,也可选 PostgreSQL 或 SQL Server)。

生成的项目使用 Entity Framework Core 进行数据访问,MediatR 处理请求,AutoMapper 与 FluentValidation 负责对象映射和校验,并使用 Scalar 提供 API 文档。测试基于 NUnit、Shouldly、Moq 和 Respawn。本地开发时由 Aspire 统一编排应用及其依赖。

模板以 NuGet 包形式发布,按 .NET 版本维护分支,早期 .NET 版本也保留在对应分支中。

核心功能

  • 01通过 dotnet new 生成 Angular、React 或纯 API 的解决方案。
  • 02支持 SQLite、PostgreSQL 和 SQL Server 三种数据库。
  • 03代码按领域、应用、基础设施和 Web 项目分层组织。
  • 04内置 MediatR、AutoMapper 和 FluentValidation 处理业务逻辑与校验。
  • 05借助 Aspire 本地运行,并提供显示应用地址和日志的仪表板。
  • 06配置了 NUnit、Shouldly、Moq 和 Respawn 的测试环境。

适用场景

  • 从一开始就需要分层结构的企业级 ASP.NET Core 新项目。
  • 搭配 Angular 或 React 单页应用的 Web API 后端。
  • 学习 Clean Architecture 在 .NET 项目中的实际落地方式。

快速上手

  1. 1

    安装 .NET 模板

    dotnet new install Clean.Architecture.Solution.Template
  2. 2

    使用所选前端框架和数据库创建新解决方案

    dotnet new ca-sln --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName
  3. 3

    使用 Aspire CLI 运行应用(推荐)

    aspire run

使用前须知

  • 需要 .NET 10.0 SDK 或更高版本。
  • 使用 SQL Server 或 PostgreSQL 需要 Docker Desktop 或 Podman。

标签

常见问题

CleanArchitecture 是什么?
基于 Clean Architecture 的 ASP.NET Core 解决方案模板,可选 Angular、React 或纯 Web API。 该模板用于生成基于 Clean Architecture 分层结构的 ASP.NET Core 解决方案,将领域、应用、基础设施和 Web 层分开组织。使用 dotnet CLI 创建时,可以选择前端框架(Angular、React,或不带前端的纯 API)和数据库(默认 SQLite,也可选 PostgreSQL 或 SQL Server)。
CleanArchitecture 可以免费使用吗?用的什么许可证?
CleanArchitecture 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
CleanArchitecture 还在维护吗?
活跃维护中。CleanArchitecture 最近一次提交是在 2026年10月21日。
CleanArchitecture 适合用来做什么?
从一开始就需要分层结构的企业级 ASP.NET Core 新项目。 搭配 Angular 或 React 单页应用的 Web API 后端。 学习 Clean Architecture 在 .NET 项目中的实际落地方式。
CleanArchitecture 怎么安装和运行?
安装 .NET 模板: dotnet new install Clean.Architecture.Solution.Template 使用所选前端框架和数据库创建新解决方案: dotnet new ca-sln --client-framework [angular|react|none] --database [postgresql|sqlite|sqlserver] --output YourProjectName 使用 Aspire CLI 运行应用(推荐): aspire run
在哪里获取 CleanArchitecture?
源代码和安装说明在 GitHub 上:https://github.com/jasontaylordev/CleanArchitecture

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目