Spark.NET：一个试图把 Django / Rails 式开发体验带回 .NET 世界的全栈 Web 框架

这个框架并没有创造一套全新的技术，而是把 ASP.NET Core、EF Core、Blazor SSR / Razor Pages、Vite、Tailwind、认证、队列、定时任务、CLI 这些东西，用「约定优于配置」的方式预装、整合、规范化。

算是一个不错的脚手架。

框架定位#

Spark.NET 官方对自己的定义是：一个基于 ASP.NET 与 Entity Framework 基础能力扩展出来的full-stack web application framework，目标是让开发者更快构建功能完整的单体全栈 Web 应用。

官方文档明确说，它的目标是帮助开发者轻松构建「monolithic, full stack web applications」。

GitHub README 里的描述也很直接：The .NET Web Framework for Makers，强调「production-grade」「full-stack」「without sweating the small stuff」。

不过截至我查询时，仓库显示 767 stars、60 forks，MIT License，并且暂无正式 releases。

这意味着它是更像一个「ASP.NET Core 的产品化脚手架 + 框架约定层」。

特色#

面向独立开发者和小团队的「全栈单体」思路#

Spark.NET 的默认取向不是微服务和前后端完全分离，而是Monolithic Full-stack Web App。

很多 .NET 项目天然偏企业级、偏分层、偏重型，而 Spark.NET 的气质更像 Laravel、Rails、Django：先把认证、邮件、日志、事件、后台队列、定时任务、用户面板这些常用能力准备好，让开发者直接进入业务开发。

官方介绍里列出的预配置能力包括 Authentication、Mail、Logging、Events & Listeners、Background Queues、Scheduled Jobs，并且还会脚手架生成登录、注册、用户仪表盘、用户资料页。

适合在文章里点出一句：

这不是「更底层的 ASP.NET Core」，而是「更接近产品开发体验的 ASP.NET Core」。

「约定优于配置」设计#

Spark.NET 强调固定项目结构。官方文档说，每个 Spark 项目都有相同的项目结构，让开发者无论第一次接触还是维护已有项目，都能知道东西在哪里。

它的目录结构也很清晰：

Application/ Database/ Events/ Jobs/ Mail/ Models/ Services/ Startup/ Assets/ Pages/ Storage/ wwwroot/

其中Application放核心业务代码，Database放 EF Core 的DatabaseContext和迁移文件，Events放事件与监听器，Jobs放队列任务或定时任务，Mail放邮件类，Models放 EF Core 模型，Services放可注入服务，Startup放 DI 注册、认证、事件、任务注册等启动配置。

这个结构给人的感觉非常「Django 化」：不用纠结代码应该放哪里，直接给你一个默认答案。

Blazor SSR / Razor Pages#

Spark.NET 提供两个前端选项：Blazor SSR和Razor Pages。官方文档明确列出这两个方向。

现在很多全栈方案默认是 React / Next.js / Vue / Nuxt，而 Spark.NET 选择留在 .NET 生态里：

• Blazor SSR：使用 Razor Components 组织 UI；
• Razor Pages：传统服务端渲染页面；
• 可以用 HTMX 增强导航、表单提交、局部刷新；
• Razor Pages 还可以搭配 Hydro，让后端 C# 组件拥有类似 React 的交互体验。

这对熟悉 C# 的独立开发者、小型 SaaS、内部系统、后台管理类产品，会比较友好。

内置现代前端工程链#

Vite + Tailwind CSS + DaisyUI

虽然它不是 React/Vue 路线，但 Spark.NET 并不排斥现代前端工具。官方文档说，Spark 项目默认通过 NPM 安装 Tailwind CSS 和 DaisyUI，自定义 CSS 放在Assets/Css/app.css，并通过 Vite 进行 CSS / JS 打包。

更有意思的是，Spark 使用Vite.AspNetCoreNuGet 包，在本地开发时自动启动 Vite server；同时在dotnet build或dotnet publish时自动构建前端资源。

优秀的CLI体验#

Spark.NET 提供自己的 CLI。安装方式是：

dotnet tool install -g Spark.CLI

然后可以执行：

spark install spark update spark new MyApp spark make model Developer spark make migration AddDeveloperTable spark migrate spark make component Profile/ProfileDetails spark make page Profile/Index spark make event UserRegistered SendWelcomeEmail spark make mail WelcomeMail spark make service DeveloperService spark make job ExampleJob

官方文档列出了这些命令，CLI 可以创建项目、模型、迁移、组件、页面、事件、邮件、服务、任务等文件。

Spark.NET 试图提供完整的开发工作流，非常现代的开发体验。

数据库集成#

Spark.NET 默认接入 EFCore，并且新项目默认已经配置好 SQLite。官方文档列出的数据库支持包括 SQLite、PostgreSQL、MySQL 和 SQL Server，数据库配置放在.env文件里，通过DB_CONNECTION切换。

模型方面，它要求模型继承BaseModel，这个基类包含Id、CreatedAt、UpdatedAt三个属性。迁移则通过：

spark make migration AddDeveloperTable spark migrate

完成。官方也提供了Save、Delete这样的 EF Core 扩展方法，减少常规增删改代码。

这也能体现它的设计哲学：把 EF Core 的使用体验变得更顺手。

预置认证、权限、API 路由#

认证方面，Spark.NET 基于 .NET Authentication，并提供自己的 cookie provider；登录、退出、注册、资料编辑页面都会生成好。认证配置可以放在appsettings.json中，比如登录路径、Cookie 过期天数、密码强度规则