62 lines
1.6 KiB
Markdown
62 lines
1.6 KiB
Markdown
|
# VS Code调试演示
|
|||
|
|
|
|||
|
|
你现在已经成功配置了VS Code调试环境！下面是具体的使用步骤：
|
|||
|
|
|
|||
|
|
## 🎯 立即开始调试
|
|||
|
|
|
|||
|
|
### 步骤1: 打开VS Code
|
|||
|
|
如果还没有在VS Code中打开项目：
|
|||
|
|
```bash
|
|||
|
|
cd /home/fl/code/ai-solution/agentic-rag-4
|
|||
|
|
code .
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 步骤2: 选择Python解释器
|
|||
|
|
1. 按 `Ctrl+Shift+P`
|
|||
|
|
2. 输入 "Python: Select Interpreter"
|
|||
|
|
3. 选择 `.venv/bin/python`
|
|||
|
|
|
|||
|
|
### 步骤3: 设置断点
|
|||
|
|
在 `service/llm_client.py` 的第42行（`astream` 方法）设置断点：
|
|||
|
|
- 点击行号左侧设置红色断点
|
|||
|
|
|
|||
|
|
### 步骤4: 开始调试
|
|||
|
|
1. 按 `Ctrl+Shift+D` 打开调试面板
|
|||
|
|
2. 选择 "Debug Service with uvicorn"
|
|||
|
|
3. 按 `F5` 或点击绿色箭头
|
|||
|
|
|
|||
|
|
### 步骤5: 触发断点
|
|||
|
|
在另一个终端运行测试：
|
|||
|
|
```bash
|
|||
|
|
cd /home/fl/code/ai-solution/agentic-rag-4
|
|||
|
|
uv run python scripts/test_real_streaming.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
断点将在LLM流式调用时触发！
|
|||
|
|
|
|||
|
|
## 📋 可用的调试配置
|
|||
|
|
|
|||
|
|
1. **Debug Agentic RAG Service** - 直接调试服务
|
|||
|
|
2. **Debug Service with uvicorn** - 推荐，使用uvicorn调试
|
|||
|
|
3. **Run Tests** - 调试测试用例
|
|||
|
|
4. **Run Streaming Test** - 调试流式测试
|
|||
|
|
|
|||
|
|
## 🛠️ 调试功能
|
|||
|
|
|
|||
|
|
- **断点调试**: 在任意行设置断点
|
|||
|
|
- **变量查看**: 鼠标悬停或查看变量面板
|
|||
|
|
- **调用栈**: 查看函数调用链
|
|||
|
|
- **监视表达式**: 添加自定义监视
|
|||
|
|
- **调试控制台**: 执行Python表达式
|
|||
|
|
|
|||
|
|
## 🔧 常用快捷键
|
|||
|
|
|
|||
|
|
- `F5` - 开始调试/继续
|
|||
|
|
- `F9` - 切换断点
|
|||
|
|
- `F10` - 单步跳过
|
|||
|
|
- `F11` - 单步进入
|
|||
|
|
- `Shift+F11` - 单步跳出
|
|||
|
|
- `Shift+F5` - 停止调试
|
|||
|
|
|
|||
|
|
现在你可以在VS Code中愉快地调试你的服务了！🚀
|