# Python-debug-demo

**Repository Path**: ghostmen/python-debug-demo

## Basic Information

- **Project Name**: Python-debug-demo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-16
- **Last Updated**: 2026-01-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python 在线调试器

一个基于 Vue 3 前端和 Java Spring Boot 后端的 Python 代码在线执行和调试工具。

## 功能特性

- ✅ 在线 Python 代码编辑器（基于 CodeMirror）
- ✅ 代码执行功能
- ✅ 代码调试功能（支持断点）
- ✅ 实时输出显示
- ✅ 错误信息展示
- ✅ 代码高亮和语法提示

## 技术栈

### 前端
- Vue 3
- Vite
- CodeMirror 6
- Axios

### 后端
- Java 17
- Spring Boot 3.2.0
- Maven

## 项目结构

```
.
├── backend/              # Java Spring Boot 后端
│   ├── src/
│   │   └── main/
│   │       ├── java/
│   │       │   └── com/pythondebug/
│   │       │       ├── PythonDebugApplication.java
│   │       │       ├── config/        # 配置类
│   │       │       ├── controller/    # REST API 控制器
│   │       │       ├── service/       # 业务逻辑服务
│   │       │       └── dto/           # 数据传输对象
│   │       └── resources/
│   │           └── application.properties
│   └── pom.xml
├── frontend/            # Vue 3 前端
│   ├── src/
│   │   ├── App.vue      # 主组件
│   │   ├── main.js      # 入口文件
│   │   └── style.css    # 样式文件
│   ├── index.html
│   ├── package.json
│   └── vite.config.js
└── README.md
```

## 环境要求

### 后端
- JDK 17 或更高版本
- Maven 3.6+
- Python 3.x（需要安装并配置在系统PATH中）

### 前端
- Node.js 16+ 
- npm 或 yarn

## 安装和运行

### 1. 启动后端服务

```bash
cd backend
mvn clean install
mvn spring-boot:run
```

后端服务将在 `http://localhost:8080` 启动

### 2. 启动前端服务

```bash
cd frontend
npm install
npm run dev
```

前端服务将在 `http://localhost:3000` 启动

### 3. 使用启动脚本（Windows）

- 双击 `start-backend.bat` 启动后端
- 双击 `start-frontend.bat` 启动前端

### 4. 使用启动脚本（Linux/Mac）

```bash
chmod +x start-backend.sh start-frontend.sh
./start-backend.sh    # 在一个终端运行
./start-frontend.sh   # 在另一个终端运行
```

### 3. 访问应用

在浏览器中打开 `http://localhost:3000`

## API 接口

### 执行代码
```
POST /api/python/execute
Content-Type: application/json

{
  "code": "print('Hello, World!')",
  "sessionId": "session_123"
}
```

### 调试代码
```
POST /api/python/debug
Content-Type: application/json

{
  "code": "print('Hello, World!')",
  "sessionId": "session_123",
  "breakpoints": [3, 5],
  "action": "start"
}
```

### 停止执行
```
POST /api/python/stop/{sessionId}
```

## 使用说明

1. **编写代码**：在左侧编辑器中输入 Python 代码
2. **设置断点**：
   - 在编辑器顶部的"行号"输入框中输入要设置断点的行号
   - 点击"添加断点"按钮
   - 可以设置多个断点
   - 点击"清空断点"可以清除所有断点
3. **运行代码**：点击"运行"按钮执行代码（不触发断点）
4. **调试代码**：点击"调试"按钮进入调试模式（会在设置的断点处暂停）
5. **查看输出**：右侧面板显示执行结果和错误信息
6. **停止执行**：如果代码执行时间过长，可以点击"停止"按钮

## 注意事项

- 确保系统已安装 Python 3.x 并配置在 PATH 中
- 代码执行有30秒超时限制
- 调试功能使用 Python 的 pdb 模块实现
- 生产环境建议使用更专业的调试器如 debugpy

## 开发计划

- [ ] 支持断点可视化设置
- [ ] 支持单步执行、步入、步出等调试操作
- [ ] 支持变量查看和修改
- [ ] 支持多文件编辑
- [ ] 支持代码自动补全
- [ ] 使用 WebSocket 实现实时交互式调试

## 许可证

MIT License