# 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）

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

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

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

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

也可在终端运行：

```powershell
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 连接串，或改用远程测试库。

**构建失败**

在项目根目录执行：

```powershell
dotnet build SimpleAdmin.sln
```

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