aspnet-core

ASP.NET Core

概觀

選擇合適的 ASP.NET Core 應用程式模型，正確組合 Host 與要求管線（Request Pipeline），並遵循微軟當前官方文件推薦的框架風格來實作各項功能。

僅載入符合當前任務所需的最小參考資料集，切勿預設載入所有參考文件。

工作流程

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、健康檢查（Health Checks）、流量限制（Rate Limiting）、輸出快取（Output Caching）及 Identity，避免過早引入第三方基礎設施。
• 保持功能切片（Feature Slices）的高凝聚性，使頁面、元件、端點、Controller、驗證邏輯、服務、資料存取與測試利於追蹤與維護。
• 尊重專案現有的應用程式模型。無明確合理原因時，切勿擅自將 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 Mode），並正確使用元件、表單與 JS 互操作（JS Interop）。
• references/ui-razor-pages.md：運用 Handler、模型繫結（Model Binding）與慣例，開發以頁面為核心的伺服器端轉譯應用程式。
• 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、機密管理（Secrets）、資料保護（Data Protection）、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 官方文件庫核對細節，切勿僅憑記憶撰寫。