# Fast.NET **Repository Path**: FastDotnet/Fast.NET ## Basic Information - **Project Name**: Fast.NET - **Description**: 一个应用程序工具类（框架），您可以将它集成到任何 .NET 应用程序中。 - **Primary Language**: C# - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://fastdotnet.com - **GVP Project**: No ## Statistics - **Stars**: 7 - **Forks**: 2 - **Created**: 2024-09-05 - **Last Updated**: 2026-09-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README [**简体中文**](README.zh.md) | [English](README.md)

Fast.NET Logo

Fast.NET

面向现代 .NET 应用的模块化基础设施 SDK

NuGet version NuGet downloads Supported .NET versions Apache-2.0 License

Fast.NET 是一组可按需组合的 .NET 基础设施库，覆盖 Web 应用初始化、依赖注入、缓存、事件总线、日志、对象映射、认证、数据访问、序列化、动态 API、统一响应、Swagger/OpenAPI 与 Consul 集成。每项能力都以独立 NuGet 包交付，应用只需引用真正需要的模块。 > Fast.NET 不是一个必须整体引入的“大而全”框架。它更像一组具有一致设计和配置体验的 SDK 组件，可用于 ASP.NET Core、Worker Service，以及适合对应模块的其他现代 .NET 应用。 ## 为什么选择 Fast.NET - **模块化**：17 个独立包，按需安装，避免无关依赖进入应用。 - **支持期内版本**：主要模块同时支持 `net8.0`、`net9.0`、`net10.0`。 - **通用基础设施**：`Fast.IaaS` 保持 `netstandard2.1`，便于被不同现代 .NET 项目复用。 - **一致的扩展方式**：围绕 `IServiceCollection`、`WebApplicationBuilder` 和 `IApplicationBuilder` 提供惯用扩展方法。 - **可独立采用**：缓存、日志、序列化、数据访问等模块可单独使用，无需绑定完整技术栈。 - **面向发布**：提供确定性构建、集中依赖管理、漏洞审计、符号包、CI 与需明确确认的发布脚本。 ## 兼容性 | 项目 | 兼容范围 | | --- | --- | | 主要 SDK 模块 | `net8.0; net9.0; net10.0` | | `Fast.IaaS` | `netstandard2.1` | | 编译 SDK | 由 [`global.json`](global.json) 固定为 .NET SDK `10.0.100`，允许向后滚动到更新 feature band | | C# 语言版本 | C# 14 | | 许可证 | Apache-2.0 | `netstandard2.1` 不支持传统 .NET Framework。如果应用仍运行在 .NET Framework 上，需要单独评估兼容方案。 ## 快速开始 ### 1. 安装所需模块 Fast.NET 没有强制性的总包。请选择实际需要的 NuGet 包： ```bash dotnet add package Fast.NET.Core dotnet add package Fast.Serialization.System.Text.Json dotnet add package Fast.Swagger ``` 例如，需要 Redis 缓存、JWT 认证或 SqlSugar 时，再分别安装： ```bash dotnet add package Fast.Cache dotnet add package Fast.JwtBearer dotnet add package Fast.SqlSugar ``` > `Fast.Serialization.System.Text.Json` 与 `Fast.Serialization.Newtonsoft.Json` 提供相同风格的序列化扩展。通常根据项目技术选型选择其中一个。 ### 2. 注册服务 下面展示一个组合多个模块的 ASP.NET Core 示例。只保留项目实际安装的模块即可。 ```csharp using Fast.Cache; using Fast.DependencyInjection; using Fast.DynamicApplication; using Fast.EventBus; using Fast.JwtBearer; using Fast.Logging; using Fast.Mapster; using Fast.NET.Core; using Fast.OpenApi; using Fast.Serialization; using Fast.SqlSugar; using Fast.Swagger; using Fast.UnifyResult; var builder = WebApplication.CreateBuilder(args); builder.Initialize(); builder.AddCorsAccessor(); builder.Services.AddSerialization(); builder.Services.AddGzipCompression(); builder.Services.AddMapster(); builder.Services.AddDependencyInjection(); builder.Services.AddEventBus(); builder.Services.AddCache(); builder.Services.AddLoggingService(builder.Configuration); builder.Services.AddSqlSugar(builder.Configuration, builder.Environment); builder.Services.AddJwtBearer(builder.Configuration); builder.Services.AddUnifyResult(); builder.Services.AddControllers(); builder.Services.AddDynamicApplication(); builder.Services.AddSwaggerDocuments(builder.Configuration); builder.Services.AddOpenApi(builder.Configuration); var app = builder.Build(); app.UseHttpsRedirection(); app.UseStaticFiles(); app.EnableBuffering(); app.UseRouting(); app.UseSwaggerDocuments(); app.MapControllers(); app.Run(); ``` `Fast.Runtime` 3.5.29 提供 `MAppContext.ConsoleWrite`，在同步回调结束后自动恢复控制台前景色和背景色，输出重定向时使用纯文本。启动横幅和直接诊断输出已统一使用该写入器，使用示例与日志链路见[控制台输出](docs/MODULES.zh.md#控制台输出)。 `Fast.NET.Core` 3.5.36 扩展 `builder.Initialize()` 启动横幅，展示应用与框架版本、.NET 运行时、运行环境、主机、操作系统、系统与进程架构以及本地启动时间。版本来源和颜色说明见上述模块手册。 `Fast.IaaS` 3.5.27 修复 `TimeSpanExtension.ToDescription()` 在恰好一分钟、一小时和一天时丢失对应单位的问题，避免向较小单位回绕后显示为零。 `Fast.Runtime` 3.5.30 使 HTTP 上下文扩展在非请求环境中安全返回默认值，远程地址仅使用可信转发头中间件处理后的结果，并删除语义不准确的 `LanIpv4()` 和 `LanIpv6()`。`Fast.NET.Core` 3.5.38 在请求上下文不可用时返回 `HttpRequestMethodEnum.Unknown`，`Fast.SqlSugar` 3.5.65 允许请求审计信息缺失。 本次发布同步更新 15 个 SDK 包，两个序列化包沿用原版本。引用 `Fast.Runtime` 的模块要求 3.5.30 或更高版本；升级时请按 [CHANGELOG](CHANGELOG.md) 中的版本清单同步更新已安装的模块。 各模块的默认配置节点和可选参数以对应源码中的 `*SettingsOptions` 与扩展方法 XML 文档为准。 ## 项目架构 ```mermaid flowchart TB app["ASP.NET Core / Worker / Console 应用"] subgraph api["Web 与 API 集成"] swagger["Fast.Swagger"] openapi["Fast.OpenApi"] dynamic["Fast.DynamicApplication"] unify["Fast.UnifyResult"] jwt["Fast.JwtBearer"] consul["Fast.Consul"] end subgraph capability["基础设施能力"] cache["Fast.Cache"] eventbus["Fast.EventBus"] logging["Fast.Logging"] mapster["Fast.Mapster"] di["Fast.DependencyInjection"] sqlsugar["Fast.SqlSugar"] serialization["Fast.Serialization.*"] end subgraph foundation["核心基础"] core["Fast.NET.Core"] runtime["Fast.Runtime"] iaas["Fast.IaaS · netstandard2.1"] end app --> api app --> capability api --> foundation capability --> foundation core --> runtime swagger --> dynamic dynamic --> unify consul --> core consul --> iaas ``` 这张图展示模块的职责分层；实际项目引用关系、启动流程和扩展边界请参阅[架构说明](docs/ARCHITECTURE.zh.md)。 ## 模块目录 | NuGet 包 | 主要能力 | 目标框架 | 源码 | | --- | --- | --- | --- | | [`Fast.Runtime`](https://www.nuget.org/packages/Fast.Runtime) | ASP.NET Core 运行时基础、上下文与通用扩展 | .NET 8–10 | [`src/Runtime`](src/Runtime) | | [`Fast.IaaS`](https://www.nuget.org/packages/Fast.IaaS) | 通用扩展、校验、文件与密码学工具 | .NET Standard 2.1 | [`src/IaaS`](src/IaaS) | | [`Fast.NET.Core`](https://www.nuget.org/packages/Fast.NET.Core) | 应用初始化、配置加载、CORS、压缩等核心能力 | .NET 8–10 | [`src/Core`](src/Core) | | [`Fast.Cache`](https://www.nuget.org/packages/Fast.Cache) | 基于 CSRedisCore 的 Redis 缓存封装 | .NET 8–10 | [`src/Cache`](src/Cache) | | [`Fast.Consul`](https://www.nuget.org/packages/Fast.Consul) | Consul 服务注册、健康检查与 KV 集成 | .NET 8–10 | [`src/Consul`](src/Consul) | | [`Fast.DependencyInjection`](https://www.nuget.org/packages/Fast.DependencyInjection) | 约定式依赖注入与服务扫描 | .NET 8–10 | [`src/DependencyInjection`](src/DependencyInjection) | | [`Fast.DynamicApplication`](https://www.nuget.org/packages/Fast.DynamicApplication) | 动态 API 与应用服务发现 | .NET 8–10 | [`src/DynamicApplication`](src/DynamicApplication) | | [`Fast.EventBus`](https://www.nuget.org/packages/Fast.EventBus) | 进程内事件发布、订阅与后台消费 | .NET 8–10 | [`src/EventBus`](src/EventBus) | | [`Fast.JwtBearer`](https://www.nuget.org/packages/Fast.JwtBearer) | JWT Bearer 配置、认证与授权辅助 | .NET 8–10 | [`src/JwtBearer`](src/JwtBearer) | | [`Fast.Logging`](https://www.nuget.org/packages/Fast.Logging) | 控制台与文件日志扩展 | .NET 8–10 | [`src/Logging`](src/Logging) | | [`Fast.Mapster`](https://www.nuget.org/packages/Fast.Mapster) | Mapster 对象映射集成 | .NET 8–10 | [`src/Mapster`](src/Mapster) | | [`Fast.OpenApi`](https://www.nuget.org/packages/Fast.OpenApi) | OpenAPI 模型与 JavaScript/TypeScript 客户端生成 | .NET 8–10 | [`src/OpenApi`](src/OpenApi) | | [`Fast.Serialization.System.Text.Json`](https://www.nuget.org/packages/Fast.Serialization.System.Text.Json) | System.Text.Json 配置、转换器与数据脱敏 | .NET 8–10 | [`src/Serialization.System.Text.Json`](src/Serialization.System.Text.Json) | | [`Fast.Serialization.Newtonsoft.Json`](https://www.nuget.org/packages/Fast.Serialization.Newtonsoft.Json) | Newtonsoft.Json 配置、转换器与数据脱敏 | .NET 8–10 | [`src/Serialization.Newtonsoft.Json`](src/Serialization.Newtonsoft.Json) | | [`Fast.SqlSugar`](https://www.nuget.org/packages/Fast.SqlSugar) | SqlSugar、多数据库配置、仓储与分页模型 | .NET 8–10 | [`src/SqlSugar`](src/SqlSugar) | | [`Fast.Swagger`](https://www.nuget.org/packages/Fast.Swagger) | Swagger 文档、分组、安全定义与过滤器 | .NET 8–10 | [`src/Swagger`](src/Swagger) | | [`Fast.UnifyResult`](https://www.nuget.org/packages/Fast.UnifyResult) | RESTful 统一响应、异常处理与数据验证 | .NET 8–10 | [`src/UnifyResult`](src/UnifyResult) | `Fast.OpenApi` 生成的 TypeScript 客户端使用独立的 `import type` 和显式 `Promise` 返回类型。返回非泛型 `Task` 或 `ValueTask` 的接口映射为 `Promise`。`Download`、`Export` 接口保留文件响应：Web 端使用 `AxiosResponse`，移动端兼容 `Blob`、`ArrayBuffer` 或临时文件路径 `string`；`autoDownloadFile` 参数默认值为 `true`，调用方可关闭。其他缺少明确 Schema 的值仍映射为 `unknown`。生成结果可直接配合 `verbatimModuleSyntax` 与当前 Fast ESLint Config 规则使用。 ## 仓库结构 ```text Fast.NET/ ├─ src/ # 17 个可独立发布的 SDK 模块 ├─ docs/ # 中英文入门、架构、模块和发布文档 ├─ .github/ # GitHub CI 工作流 ├─ translateTool/ # Vue 国际化文案提取与回写工具 ├─ Directory.Build.props # 统一目标框架、打包和仓库元数据 ├─ Directory.Packages.props # 集中管理 NuGet 依赖版本 ├─ global.json # .NET SDK 选择策略 ├─ Fast.NET.sln # 主解决方案 ├─ UploadNuget.bat # 构建、打包和可选发布入口 ├─ README.zh.md / README.md # 中英文项目入口 └─ LICENSE # Apache-2.0 许可证 ``` ## 本地构建 安装与 [`global.json`](global.json) 匹配的 .NET SDK 后执行： ```bash dotnet restore Fast.NET.sln dotnet build Fast.NET.sln -c Release --no-restore ``` 在 Windows 上构建并打包所有 SDK 项目： ```bat UploadNuget.bat pack ``` 单独生成 NuGet 包： ```bash dotnet pack Fast.NET.sln -c Release --no-build --no-restore -p:WarnOnPackingNonPackableProject=false ``` 构建不会隐式打包。`UploadNuget.bat` 会依次还原、构建并将 SDK 包输出到 `nupkgs`；发布是最后的可选步骤，推送前必须明确输入 `PUBLISH`。 ## 文档与协作 - [快速开始](docs/GETTING_STARTED.zh.md) - [模块目录](docs/MODULES.zh.md) - [架构说明](docs/ARCHITECTURE.zh.md) - [注释与公共 API 文档规范](docs/COMMENTING_GUIDE.zh.md) - [发布指南](docs/RELEASING.zh.md) - [贡献指南](CONTRIBUTING.zh.md) - [安全策略](SECURITY.md) - [支持策略](SUPPORT.md) - [行为准则](CODE_OF_CONDUCT.md) - [变更记录](CHANGELOG.md) - [国际化工具](translateTool/README.zh.md) - [更新记录](https://gitee.com/FastDotnet/Fast.NET/commits/master) - [问题反馈](https://gitee.com/FastDotnet/Fast.NET/issues) - [参与贡献](https://gitee.com/FastDotnet/Fast.NET/pulls) 提交代码前请至少完成受影响目标框架的构建验证，并保持中英文公共文档同步。 ## 许可证 Fast.NET 基于 [Apache License 2.0](LICENSE) 开源。使用、修改和分发本项目时，请遵守许可证及适用法律。 ## 维护者 由 **小方（1.8K 仔）** 发起并维护。欢迎通过 Issue 和 Pull Request 参与完善 Fast.NET，为 .NET 生态提供更多可靠、易组合的基础设施选择。