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 forksMIT 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 PagesSpark.NET 提供两个前端选项Blazor SSR和Razor Pages。官方文档明确列出这两个方向。现在很多全栈方案默认是 React / Next.js / Vue / Nuxt而 Spark.NET 选择留在 .NET 生态里Blazor SSR使用 Razor Components 组织 UIRazor 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 过期天数、密码强度规则等。路由保护也比较标准可以在 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 值得放进观察列表。