# qt网络调试助手

**Repository Path**: fan-wenshan/qt-network-debugging-assistant

## Basic Information

- **Project Name**: qt网络调试助手
- **Description**: No description available
- **Primary Language**: C++
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-15
- **Last Updated**: 2025-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Qt网络调试助手

## 项目概述
Qt网络调试助手是一个基于Qt框架开发的TCP服务器工具，专为网络通信调试设计。该应用程序提供直观的图形用户界面，支持服务器监听、多客户端连接管理、数据收发等功能，适用于开发和测试网络应用程序时使用。

## 功能特点
- **多网络接口支持**：自动检测并列出本地所有IPv4地址供选择
- **端口灵活配置**：可自定义TCP监听端口（1-65535范围）
- **客户端管理**：支持多客户端同时连接，显示客户端连接状态
- **数据收发**：提供文本框界面用于发送和接收数据
- **广播功能**：支持向所有连接的客户端广播消息
- **状态监控**：实时显示客户端连接、断开状态和数据传输情况
- **用户友好界面**：清晰的布局和直观的控制按钮

## 软件架构
### 核心组件
- **Widget类**：主窗口类，负责UI交互和业务逻辑处理
- **MyComboBox类**：自定义组合框控件，支持点击事件
- **QTcpServer**：Qt网络模块，处理客户端连接请求
- **QTcpSocket**：管理与客户端的TCP通信

### 类关系图
```
+-------------+      +----------------+      +---------------+
|   Widget    |<---->|  MyComboBox    |      |  QTcpServer   |
+-------------+      +----------------+      +---------------+
        ^                                            |
        |                                            v
        +------------------------------------->+---------------+
                                               |  QTcpSocket   |
                                               +---------------+
```

## 安装指南
### 开发环境要求
- Qt 5.12.12或更高版本
- MinGW 7.3.0或兼容的C++编译器
- Windows操作系统

### 编译步骤
1. 克隆或下载项目源代码
2. 使用Qt Creator打开项目文件`TcpServer.pro`
3. 选择合适的构建套件（推荐Desktop Qt 5.12.12 MinGW 32-bit）
4. 点击构建按钮编译项目
5. 运行生成的可执行文件

## 使用说明
### 基本操作流程
1. **启动程序**：运行编译生成的可执行文件，打开主窗口
2. **配置服务器**：
   - 从下拉框选择要监听的网络接口（IPv4地址）
   - 在端口输入框中输入端口号（默认8888）
   - 点击「监听」按钮启动服务器
3. **客户端连接**：
   - 当客户端连接时，程序会自动接受连接
   - 客户端信息（IP地址和端口）会显示在接收区域
4. **数据发送**：
   - 在发送文本框中输入要发送的数据
   - 从客户端列表选择目标客户端（或选择"all"广播给所有客户端）
   - 点击「发送」按钮发送数据
5. **停止服务**：点击「停止监听」按钮关闭服务器

### 界面说明
![程序界面](https://example.com/screenshot.png)（注：实际使用时请替换为真实截图链接）

- **接收区域**：显示客户端连接状态和接收到的数据
- **地址选择**：下拉框选择服务器监听的IP地址
- **端口设置**：输入框设置服务器监听端口
- **控制按钮**：包括「监听」、「停止监听」和「断开」按钮
- **客户端列表**：显示当前连接的客户端端口号
- **发送区域**：输入要发送的数据并点击发送按钮

## 代码结构
```
qt-network-debugging-assistant/
├── main.cpp              # 程序入口
├── widget.h/.cpp         # 主窗口类定义与实现
├── mycombobox.h/.cpp     # 自定义组合框控件
├── widget.ui             # UI界面设计文件
├── TcpServer.pro         # 项目配置文件
└── README.md             # 项目说明文档
```

## 许可证
本项目采用MIT许可证 - 详情参见LICENSE文件

## 致谢
- Qt框架提供的GUI和网络功能支持
- 课程作业指导老师的帮助与支持

## 联系方式
如有问题或建议，请联系：example@example.com