为什么在ASP.NET中创建新控制器时没有「Api Controller - Empty」选项？

常见原因及对应解决方案 #

• 项目模板选择错误
  只有基于.NET Core/.NET 5+的ASP.NET Core项目才会提供该选项，如果你创建项目时选了控制台应用、类库、.NET Framework版本的ASP.NET项目，就不会显示对应模板。
  解决方式：新建项目时选择「ASP.NET Core Web API」或「ASP.NET Core Web 应用」模板，框架版本选择和教程一致的.NET LTS版本即可。

• 未安装对应的Visual Studio工作负载
  安装Visual Studio时如果没有勾选「ASP.NET 和 Web 开发」工作负载，不会预装相关项模板。
  解决方式：打开Visual Studio Installer，点击对应版本的「修改」按钮，在工作负载页勾选「ASP.NET 和 Web 开发」，等待安装完成后重启VS即可。

• 添加新项的操作路径错误
  不要直接在项目根目录选择「添加 -> 新项」查找控制器模板，正确操作是：先在项目中新建名为Controllers的文件夹，右键该文件夹选择「添加 -> 控制器」，即可直接调出控制器选项列表，找到「API 控制器 - 空」选项。

临时替代方案 #

如果上述操作都无效，可以手动创建控制器类，无需依赖项模板，示例代码如下：

using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("[controller]")]
public class 你的控制器名Controller : ControllerBase
{
    // 在此处编写接口逻辑
}

内容的提问来源于stack exchange，提问作者Amanda Scremin