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

前言

在 AI 时代，技术选型的思路变了，至少这两年，我的新项目都会偏向于单体式架构(monolithic)

最近在调用 AspNetCore 技术栈的时候，发现了一个有意思的框架 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.AspNetCore NuGet 包，在本地开发时自动启动 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 过期天数、密码强度规则等。

路由保护也比较标准，可以在 Razor 页面里使用 [Authorize]，也可以通过 PageState.User.IsAuthenticated 判断页面局部内容显示。

API 方面，它使用 Minimal APIs。只要在 Pages/Api 目录下创建实现 IRoute 接口的类，Spark 启动时会自动注册这些 API 路由；需要保护接口时可以使用 .RequireAuthorization()，也可以传入角色限制。

事件、队列、定时任务，适合真实产品开发

很多脚手架只管页面和数据库，但 Spark.NET 把后台任务也考虑进去了。官方介绍里就把 Events & Listeners、Background Queues、Scheduled Jobs 列为默认能力。

Jobs 基于 Coravel 的 IInvocable，可以用于后台队列或定时任务。官方示例里提到，可以通过 scheduler 每 5 分钟执行一次任务，例如检查不活跃用户。

对真正做产品的人来说，认证、邮件、队列、定时任务不是「以后再说」的高级功能，而是很快就会遇到的基础设施。Spark.NET 把这些提前放进了框架默认能力里。

小结

Spark.Net 是一个看起来非常不错的框架。

当然，它也不是没有问题。

首先，它目前还比较年轻。

GitHub 页面显示暂无正式 releases，这意味着生产环境采用时需要更谨慎。

其次，它的技术路线很明确：Blazor SSR / Razor Pages / C# 全栈。如果你的团队已经深度使用 React、Vue、Next.js，或者希望前后端完全分离，那 Spark.NET 不一定适合。

再次，它的生态成熟度肯定不能和 ASP.NET Core 本体、Laravel、Rails、Django 这类成熟框架相比。它更像是一个值得关注的新方向，而不是可以无脑押注的技术底座。

但我觉得 Spark.NET 有一个非常值得肯定的地方：

它意识到 .NET 生态不缺底层能力，缺的是更顺滑、更产品化、更适合快速启动项目的开发体验。

ASP.NET Core 很强，但很多时候太「底层」、太「通用」、太「你自己来」。

而独立开发者、小团队、Makers 需要的是：认证先有，用户系统先有，队列先有，定时任务先有，前端构建先有，目录结构先有，CLI 先有。

Spark.NET 的价值就在这里。

它不一定是 .NET 生态的终极答案，但它代表了一个我很喜欢的方向：让 C# 开发者也能拥有 Django / Rails 那种快速、完整、舒服的全栈开发体验。

对于想用 .NET 快速做 SaaS、内部系统、后台管理、小型产品的开发者来说，Spark.NET 值得放进观察列表。