创建后端解决方案

本页是后端初始化主线的起点，先把解决方案、项目目录和项目级包源配置固定下来。后面的宿主、WebAPI、数据访问和认证都建立在这一套目录骨架上。

这篇教程解决什么

• 一个新的后端教程样例从什么目录开始。
• 解决方案、宿主项目和项目级包源配置应该怎么组织。
• 为什么后续步骤要复用同一套 backend-starter 目录。

前置条件

• 已阅读 后端初始化。
• 本地已安装 .NET 10 SDK。
• 你准备在当前仓库里维护教程配套代码，而不是临时在别处建样例。

配套代码

• 当前样例：backend-starter
• 当前关注文件：BackendStarter.sln
• 当前关注文件：NuGet.config
• 当前关注文件：launchSettings.json

我们要做的事

• 固定样例根目录。
• 创建解决方案和后端宿主项目。
• 把项目级 NuGet 源地址显式写进仓库。

操作步骤

1. 在仓库里建立后端样例根目录。

mkdir -p samples/tutorials/backend-starter/src
cd samples/tutorials/backend-starter

2. 创建解决方案和最小 Web 项目。

dotnet new sln -n BackendStarter
dotnet new webapi -n BackendStarter.Api -o src/BackendStarter.Api --use-controllers --no-https
dotnet sln BackendStarter.sln add src/BackendStarter.Api/BackendStarter.Api.csproj

3. 在项目根目录新增 NuGet.config，把项目级包源固定下来。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="feinian" value="https://nuget.feinian.net/v3/index.json" />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
</configuration>

4. 对照最终样例，确认此时应该已经出现这些关键文件：

samples/tutorials/backend-starter/
├── BackendStarter.sln
├── NuGet.config
└── src/
    └── BackendStarter.Api/
        ├── BackendStarter.Api.csproj
        ├── Program.cs
        ├── Properties/
        │   └── launchSettings.json
        └── appsettings.json

验证结果

• BackendStarter.sln 已经存在，并且包含 src/BackendStarter.Api/BackendStarter.Api.csproj。
• NuGet.config 已经明确写入项目级 NuGet 源。
• 本地开发端口已经通过 launchSettings.json 固定为 http://localhost:5000。
• 后续教程都可以继续在同一套 backend-starter 目录上增量推进。

下一篇读什么

• 创建 Web 宿主