Cursor 调试环境（最少安装）

已自动完成

项	状态
.NET 8 SDK (`8.0.422`)	已通过 winget 安装
NuGet 包还原	`dotnet restore` 已成功
`.vscode/launch.json`	F5 调试配置
`.vscode/tasks.json`	构建任务
`.vscode/extensions.json`	推荐 C# 扩展

你需要手动做（2 步）

1. 安装 Cursor 扩展

在 Cursor 中打开扩展面板，安装：

C#（ms-dotnettools.csharp）

打开本项目时若提示「安装推荐扩展」，点安装即可。

不需要安装完整的 C# Dev Kit，只装 C# 扩展即可断点调试。

2. 用正确文件夹打开工作区

在 Cursor 中打开：

C:\Users\wilso\Desktop\oms0414-后端

（必须打开含 SimpleAdmin.sln 的目录，调试配置才能生效。）

开始调试

方式 A：调试 API（需 MySQL）

修改 src/SimpleAdmin.Api/appsettings.Development.json 里的 ConnectionStrings:Default 为你的数据库连接
按 F5，选择 「SimpleAdmin.Api（F5 调试 API）」
浏览器访问 http://localhost:5281/index.html（Swagger）

在任意 .cs 文件打断点（如 RechargeService.cs、ParcelBillingCalculator.cs），触发对应接口即可命中。

方式 B：调试单元测试（无需数据库）

按 F5，选择 「Oms.Tests（调试当前测试）」
或在测试方法上右键 → Debug Test（需 C# 扩展识别 xUnit）

也可在终端运行：

dotnet test src/Oms.Tests/Oms.Tests.csproj

方式 C：测试资源管理器

安装 C# 扩展后，左侧 Testing 面板会列出 Oms.Tests 中的用例，可单独运行/调试。

常用快捷键

操作	快捷键
开始/继续调试	F5
单步跳过	F10
单步进入	F11
停止调试	Shift+F5
切换断点	F9

配置说明

Development 环境：ASPNETCORE_ENVIRONMENT=Development，读取 appsettings.Development.json
UseLocalConfigs=true：不连 Consul，全部用本地配置
API 端口：http://localhost:5281（与 launchSettings.json 一致）

若本机没有 MySQL，可只调试 Oms.Tests 中的纯逻辑（如 ParcelBillingCalculatorTests），无需启动 API。

故障排查

终端找不到 dotnet

关闭并重新打开 Cursor（或新开终端），让 PATH 生效。

扩展装不上 / 调试按钮灰色

确认工作区根目录是 oms0414-后端，且已安装 ms-dotnettools.csharp。

API 启动报数据库连接失败

检查 appsettings.Development.json 中的 MySQL 连接串，或改用远程测试库。

构建失败

在项目根目录执行：

dotnet build SimpleAdmin.sln

根据错误信息修复后再 F5。

2.8 KiB Raw Blame History Unescape Escape