跳到正文

简体中文 | English · 返回 README

Fast.NET 入门 ​

本文提供从选择模块、注册服务到验证应用的最短路径。完整模块边界和配置入口见模块手册。

前置条件 ​

  • 使用 Fast.NET 的应用面向 .NET 8、.NET 9 或 .NET 10。
  • 构建 Fast.NET 源码仓库需要其 global.json 指定的 .NET 10 SDK。
  • Redis、Consul、数据库等外部服务只在安装对应模块时需要;基础 SDK 接入无需外部服务。

创建应用 ​

bash
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。

csharp
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。

json
{
	"SwaggerSettings": {
		"Enable": true,
		"DocumentTitle": "My Fast.NET API",
		"EnableAuthorized": false
	}
}

如果使用 Fast.DynamicApplication,必须先调用 AddControllers() 或 AddControllersWithViews(),再调用 AddDynamicApplication()。

启动并验证 ​

在刚创建的 MyFastApp 目录运行:

bash
dotnet run

使用启动日志里的监听地址访问 GET /health。例如日志显示 http://localhost:5000 时,在浏览器打开 http://localhost:5000/health。预期状态为 HTTP 200,响应体为 {"status":"ok"}。

需要把接口接到前端表格时,可按远程分页指南创建并运行最小示例。

从源码构建 ​

以下命令的工作目录是 Fast.NET 源码仓库根目录。文档维护不会自动执行这些命令,也不会启动生成的应用。

bash
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=false

Windows 用户可以通过仓库的单文件入口依次还原、构建并打包:

bat
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。

在自己的应用项目根目录使用上述固定包引用,再执行:

bash
dotnet restore
dotnet build -c Release --no-restore

示例已使用这些固定依赖完成 .NET 8、9、10 的 Release 编译,0 个警告、0 个错误;没有启动应用。其他模块页面新增片段不在此工程的编译范围内。