Fast.NET 入门
本文提供从选择模块、注册服务到验证应用的最短路径。完整模块边界和配置入口见模块手册。
前置条件
- 使用 Fast.NET 的应用面向 .NET 8、.NET 9 或 .NET 10。
- 构建 Fast.NET 源码仓库需要其
global.json指定的 .NET 10 SDK。 - Redis、Consul、数据库等外部服务只在安装对应模块时需要;基础 SDK 接入无需外部服务。
创建应用
dotnet new web -n MyFastApp -f net10.0
cd MyFastApp
dotnet add package Fast.NET.Core --version 3.5.42
dotnet add package Fast.Serialization.System.Text.Json --version 3.5.21
dotnet add package Fast.Swagger --version 3.5.37上面的命令使用入门示例验证过的 NuGet 版本。源码模块的版本记录和迁移步骤见升级与迁移。
Fast.Serialization.System.Text.Json 与 Fast.Serialization.Newtonsoft.Json 通常二选一。不要为了使用某个单独能力安装所有 Fast.NET 包。
最小配置
在创建的 Web 项目中,用下方代码替换 Program.cs。
using Fast.NET.Core;
using Fast.Serialization;
using Fast.Swagger;
var builder = WebApplication.CreateBuilder(args);
builder.Initialize();
builder.Services.AddSerialization();
builder.Services.AddControllers();
builder.Services.AddSwaggerDocuments(builder.Configuration);
var app = builder.Build();
app.UseSwaggerDocuments();
app.MapControllers();
app.MapGet("/health", () => Results.Ok(new {status = "ok"}));
app.Run();将以下节点合并到项目的 appsettings.json。
{
"SwaggerSettings": {
"Enable": true,
"DocumentTitle": "My Fast.NET API",
"EnableAuthorized": false
}
}如果使用 Fast.DynamicApplication,必须先调用 AddControllers() 或 AddControllersWithViews(),再调用 AddDynamicApplication()。
启动并验证
在刚创建的 MyFastApp 目录运行:
dotnet run使用启动日志里的监听地址访问 GET /health。例如日志显示 http://localhost:5000 时,在浏览器打开 http://localhost:5000/health。预期状态为 HTTP 200,响应体为 {"status":"ok"}。
需要把接口接到前端表格时,可按远程分页指南创建并运行最小示例。
从源码构建
以下命令的工作目录是 Fast.NET 源码仓库根目录。文档维护不会自动执行这些命令,也不会启动生成的应用。
dotnet restore Fast.NET.sln
dotnet build Fast.NET.sln -c Release --no-restore
dotnet pack Fast.NET.sln -c Release --no-build --no-restore -p:WarnOnPackingNonPackableProject=falseWindows 用户可以通过仓库的单文件入口依次还原、构建并打包:
UploadNuget.bat pack批处理文件始终先构建再打包,pack 模式不会发布。生成的包位于 nupkgs/;可选的全量或单包发布流程见发布指南。
下一步
示例编译验证
文档示例编译基线面向 net8.0;net9.0;net10.0,固定引用 Fast.NET.Core 3.5.42、Fast.Serialization.System.Text.Json 3.5.21 和 Fast.Swagger 3.5.37。
在自己的应用项目根目录使用上述固定包引用,再执行:
dotnet restore
dotnet build -c Release --no-restore示例已使用这些固定依赖完成 .NET 8、9、10 的 Release 编译,0 个警告、0 个错误;没有启动应用。其他模块页面新增片段不在此工程的编译范围内。
