教程：在 Visual Studio 中使用 React 创建 ASP.NET Core 应用

2025-10-09

本文介绍如何生成一个 ASP.NET 核心项目，以充当 API 后端，以及充当 UI 的 React 项目。

目前，Visual Studio 包括支持 Angular 和 React 的 ASP.NET 核心单页应用程序（SPA）模板。这些模板在 ASP.NET Core 解决方案中提供一个内置客户端应用文件夹，其中包含每个框架的基本文件和文件夹。

可以使用本文中所述的方法创建 ASP.NET 核心单页应用程序：

将客户端应用放在 ASP.NET 核心项目外部的单独项目中
基于计算机上安装的框架 CLI 创建客户端项目

备注

本文介绍使用 Visual Studio 2022 版本 17.11 中更新的模板创建项目的过程，该模板使用 Vite CLI。 Vite 使用项目依赖项（如在 package.json中配置的依赖项）确定 React 的版本。

先决条件

安装了“ASP.NET 和 Web 部署”工作负载的 Visual Studio 2022 版本 17.11 或更高版本。转到 Visual Studio 下载页面，免费安装它。如果需要安装工作负载并且已有 Visual Studio，请转到工具>获取工具和功能...，这将打开 Visual Studio 安装程序。选择“ASP.NET 和 web 开发”工作负载，然后选择“修改”。
npm（https://www.npmjs.com/），包含在Node.js中

创建应用

在“开始”窗口中，选择 创建新项目。

显示“创建新项目”的
在顶部的搜索栏中搜索 React，然后选择 React 和 ASP.NET Core。此模板是 JavaScript 模板。
将项目命名 ReactWithASP，然后选择“下一步”。

在“其他信息”对话框中，确保已启用“配置为 HTTPS”。在大多数情况下，将其他设置保留为默认值。
选择创建。

解决方案资源管理器显示以下项目信息：

显示解决方案资源管理器的

与独立的 React 模板相比，你会看到一些新的和修改的文件用于与 ASP.NET Core 的集成：
- vite.config.js
- App.jsx （已修改）
从“调试”工具栏中选择已安装的浏览器，例如 Chrome 或 Microsoft Edge。

如果尚未安装所需的浏览器，请先安装浏览器，然后选择它。

设置项目属性

在解决方案资源管理器中，右键单击 ReactWithASP.Server 项目，然后选择属性。
在“属性”页中，打开 “调试” 选项卡，然后选择 “打开调试启动配置文件 UI” 选项。取消选中 https 配置文件或以 ASP.NET Core 项目命名的配置文件（如果存在）的“启动浏览器”选项。

显示调试启动配置文件界面的

此值可防止使用源天气数据打开网页。

备注

在 Visual Studio 中，launch.json 存储与调试工具栏中 “开始”按钮关联的启动设置。目前，launch.json 必须位于 .vscode 文件夹下。
在“解决方案资源管理器”中右键单击此解决方案并选择“属性”。确认启动项目设置已设置为“多个项目”，并且两个项目的操作都设置为“启动”。

启动项目

按 F5 或选择窗口顶部的 “开始”按钮以启动应用。出现两个命令提示符：

正在运行的 ASP.NET Core API 项目
Vite CLI 显示一条消息，例如 VITE v4.4.9 ready in 780 ms

备注

请检查控制台输出中的消息。例如，可能有一条消息更新 Node.js。

React 应用随即显示，并通过 API 填充（localhost 端口可能与屏幕截图不同）。

显示天气预报应用的屏幕截图。

如果未在浏览器中看到天气预报数据，请参阅故障排除。

发布项目

在解决方案资源管理器中，右键单击 ReactWithASP.Server 项目，然后选择添加>项目引用。

确保已选择 reactwithasp.client 项目。
选择“确定”。
再次右键单击 ASP.NET 核心项目，然后选择 编辑项目文件。

这将打开项目的 .csproj 文件。

在 .csproj 文件中，请确保项目引用包含一个 <ReferenceOutputAssembly> 元素，其值设置为 false。

此引用应如下所示。

 <ProjectReference Include="..\reactwithasp.client\reactwithasp.client.esproj">
   <ReferenceOutputAssembly>false</ReferenceOutputAssembly>
 </ProjectReference>

右键单击 ASP.NET 核心项目，然后选择 重新加载项目（如果该选项可用）。

在 Program.cs中，请确保存在以下代码。

app.UseDefaultFiles();
app.UseStaticFiles();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
   app.UseSwagger();
   app.UseSwaggerUI();
}

若要发布，请右键单击 ASP.NET 核心项目，选择发布，然后选择与所需发布方案（如 Azure、发布到文件夹等）匹配的选项。

发布过程花费的时间比仅 ASP.NET Core 项目花费的时间要长，因为发布时会调用 npm run build 命令。默认情况下，BuildCommand 运行 npm run build。

如果要发布到文件夹，请参阅 ASP.NET Core 目录结构，以获取有关添加到 publish 文件夹中文件的详细信息。

故障排除

代理错误

你可能会看到以下错误：

[HPM] Error occurred while trying to proxy request /weatherforecast from localhost:4200 to https://localhost:7183 (ECONNREFUSED) (https://nodejs.org/api/errors.html#errors_common_system_errors)

如果看到此问题，很可能前端在后端之前启动。

看到后端命令提示符启动并运行后，只需在浏览器中刷新 React 应用。
此外，请验证后端是否已配置为在前端之前启动。若要验证，请在解决方案资源管理器中选择解决方案，从 项目菜单中选择属性。接下来，选择 配置启动项目 并确保后端 ASP.NET 核心项目位于列表中。如果不是第一个项目，请选择项目并使用向上箭头按钮使其成为启动列表中的第一个项目。

验证端口

如果天气数据无法正确加载，则可能需要验证端口是否正确。

确保端口号匹配。转到 ASP.NET Core launchSettings.json 项目中（属性文件夹中）中的文件。从 applicationUrl 属性获取端口号。

如果有多个 applicationUrl 属性，请使用 https 终结点查找一个。它看起来类似于 https://localhost:7183。
打开 React 项目的 vite.config.js 文件。更新 target 属性以匹配 applicationUrl中的属性。更新后的值如下所示：
```
target: 'https://localhost:7183/',
```

隐私错误

可能会看到以下证书错误：

Your connection isn't private

尝试从 %appdata%\local\asp.net\https 或 %appdata%\roaming\asp.net\https中删除 React 证书，然后重试。

Docker

如果您创建了带有Docker支持的项目，请执行以下步骤：

应用加载后，使用 Visual Studio 中的“容器”窗口获取 Docker HTTPS 端口。选中环境或端口选项卡。

显示 Docker 容器端口的

备注

如果未看到环境名称 ASPNETCORE_HTTPS_PORT，请使用 launchSettings.json 文件手动添加它。在节 Container (Dockerfile) 和条目 "useSSL": true后面，添加 "sslPort": <any port>。在此示例中，请使用以下内容： "sslPort": 44307

打开 React 项目的 vite.config.js 文件。更新 target 变量以匹配“容器”窗口中的 HTTPS 端口。例如，在以下代码中：
```
const target = env.ASPNETCORE_HTTPS_PORT ? `https://localhost:${env.ASPNETCORE_HTTPS_PORT}` :
   env.ASPNETCORE_URLS ? env.ASPNETCORE_URLS.split(';')[0] : 'https://localhost:7143';
```
将 https://localhost:7143 更改为匹配的 HTTPS 端口（在此示例中，https://localhost:44307）。
重启应用。

后续步骤

有关 ASP.NET Core 中的 SPA 应用程序的详细信息，请参阅开发单页应用下的 React 部分。链接的文章为项目文件（如 aspnetcore-https.js）提供了其他上下文，尽管实现的详细信息因模板差异而异。例如，React 文件包含在单独的项目中，而不是 ClientApp 文件夹。

有关特定于客户端项目的 MSBuild 信息，请参阅 JSPS的 MSBuild 属性。

反馈

此页面是否有帮助？