aspnet-core

ASP.NET Core

概述

选择合适的 ASP.NET Core 应用模型，正确组装 Host 与请求管道，并按微软现行官方风格实现各项功能。

按需加载最少量的参考文档，切勿默认加载全部参考文件。

工作流

1. 确认目标框架（Target Framework）、SDK 以及当前应用模型。
2. 新建应用或进行重大重构时，优先阅读 references/stack-selection.md。
3. 处理 Program.cs、依赖注入（DI）、配置、中间件、路由、日志及静态资源时，接着打开 references/program-and-pipeline.md。
4. 仅打开一个核心应用模型参考文档：
   • references/ui-blazor.md
   • references/ui-razor-pages.md
   • references/ui-mvc.md
   • references/apis-minimal-and-controllers.md
5. 仅在需要时补充横切（Cross-cutting）参考文档：
   • references/data-state-and-services.md
   • references/security-and-identity.md
   • references/realtime-grpc-and-background-work.md
   • references/testing-performance-and-operations.md
6. 在向旧项目引入新平台 API 或跨大版本迁移前，阅读 references/versioning-and-upgrades.md。
7. 当遇到专项文档未覆盖的任务、需要查阅微软 Microsoft Learn 对应章节时，参考 references/source-map.md。

默认开发约定

• 除非项目代码库或用户明确限定了旧版本，否则优先使用最新的稳定版 ASP.NET Core 和 .NET。
• 截至 2026 年 3 月，新生产项目优先采用 .NET 10 / ASP.NET Core 10。除非用户明确要求使用预览版特性，否则将 ASP.NET Core 11 视为 Preview 版本。
• 优先使用 WebApplicationBuilder 和 WebApplication。除非现有代码库已采用或任务涉及旧代码迁移，否则避免使用旧版 Startup 和 WebHost 模式。
• 在引入第三方基础设施前，优先使用原生内置功能：依赖注入（DI）、Options/配置、日志、ProblemDetails、OpenAPI、健康检查、限流（Rate Limiting）、输出缓存（Output Caching）及 Identity。
• 保持功能切片（Feature Slice）内聚，使页面、组件、Endpoint、Controller、数据校验、Service、数据访问及测试代码清晰易追溯。
• 尊重现有应用模型。无明确合理理由时，切勿随意将 Razor Pages 重构为 MVC，或将 Controller 重构为 Minimal APIs。

参考指南

• references/_sections.md：快速索引与推荐阅读顺序。
• references/stack-selection.md：选择正确的 ASP.NET Core 应用模型与项目模板。
• references/program-and-pipeline.md：组织 Program.cs、服务注册、中间件、路由、配置、日志及静态资源。
• references/ui-blazor.md：构建 Blazor Web Apps，合理选择渲染模式（Render Modes），正确使用组件、表单与 JS interop。
• references/ui-razor-pages.md：构建以页面为中心的服务端渲染应用，正确配置 Handler、模型绑定与约定。
• references/ui-mvc.md：构建职责分离清晰的 Controller/View 应用。
• references/apis-minimal-and-controllers.md：使用 Minimal APIs 或 Controller 构建 HTTP API，包含数据校验与响应模式。
• references/data-state-and-services.md：规范使用 EF Core、DbContext、Options、IHttpClientFactory、Session、TempData 及应用状态。
• references/security-and-identity.md：落实身份认证、授权、Identity、密钥管理、数据保护、CORS、CSRF 与 HTTPS 安全指南。
• references/realtime-grpc-and-background-work.md：使用 SignalR、gRPC 及后台托管服务（Hosted Services）。
• references/testing-performance-and-operations.md：添加集成测试、浏览器测试、缓存、压缩、健康检查、限流与部署相关实践。
• references/versioning-and-upgrades.md：处理目标框架变动、破坏性变更（Breaking Changes）、废弃 API 替换及版本迁移。
• references/source-map.md：将 ASP.NET Core 官方文档目录映射到本 Skill 的参考文档。

执行注意事项

• 生成新代码时，应从正确的 dotnet new 模板开始，保持生成的结构规范易懂。
• 修改现有项目时，优先遵循项目原有的编码规范，结合本参考指南避免滥用框架或使用过时模式。
• 当任务涉及“最新”特性时，请在 Microsoft Learn 或 ASP.NET Core 官方文档库核实最新细节，切勿仅凭记忆凭空推断。