109 lines
2.8 KiB
Markdown
109 lines
2.8 KiB
Markdown
# 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。
|