快速入门
Perigon 提供两套用途不同的模板。请先选择模板，再按对应指南创建、运行和测试项目。
| 模板 | 适用场景 | 技术边界 | 快速入门 |
|---|---|---|---|
ApiStandard |
标准 Web API、后台服务和模块化业务系统 | EF Core、Aspire 迁移资源、AdminService/ApiService、PostgreSQL 或 SQL Server | ApiStandard 快速入门 |
MiniApi |
轻量接口、微服务和资源敏感场景 | Minimal API、PostgreSQL、NativeAOT、无内置 EF 迁移资源 | MiniApi 快速入门 |
公共前提
- 安装
.NET 10.0.103或兼容的 .NET 10 SDK。 - 安装与所选模板 SDK 匹配的 Aspire CLI：ApiStandard 使用 13.6.1，MiniApi 使用 13.5.0，并准备 Docker 或 Podman。
- 安装
Perigon.CLI后使用dotnet new创建模板，或使用 Studio 创建解决方案。
直接使用模板包时，安装与本文档对应的版本：
dotnet new install Perigon.templates --version 1.3.17
模板版本、Aspire SDK 和 CLI 的对应关系请查看版本兼容矩阵。
运行和排障约定
AppHost 使用 Aspire CLI 管理，不要直接把 AppHost 当作普通 Web 项目启动：
aspire start --non-interactive aspire ps aspire otel logs
停止应用：
aspire stop --non-interactive
生产发布前请阅读生产运维 Runbook和发布应用。