# data-mock-tool

**Repository Path**: brokenheart/data-mock-tool

## Basic Information

- **Project Name**: data-mock-tool
- **Description**: 一个用于生成模拟数据的开源工具，支持多种数据格式和场景，帮助开发者快速构建测试环境。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-12
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Data Mock Tool

一个用于生成模拟数据的开源工具，支持多种数据格式和场景，帮助开发者快速构建测试环境。

## 功能特性

- **接口管理**：支持添加、编辑、删除、复制接口
- **动态响应**：通过 JavaScript 代码根据请求参数动态生成响应内容
- **条件响应**：根据入参条件返回不同的响应内容
- **文件响应**：支持返回二进制文件或 Base64 编码文件
- **标签系统**：支持为接口添加标签，便于分类管理
- **批量操作**：支持批量启用/停用接口
- **主题切换**：支持白天/黑夜模式切换

## 软件架构

- **后端**：Go + Fiber 框架
- **前端**：Vue 3 + Vite
- **管理界面**：内置 Web 管理界面
- **Mock 服务**：独立的 Mock 服务端口

## 安装教程

### 环境要求

- Go 1.18+
- Node.js 16+
- Windows/Linux/Mac

### 快速开始

1. 克隆仓库

```bash
git clone https://github.com/yourusername/data-mock-tool.git
cd data-mock-tool
```

2. 安装前端依赖并构建

```bash
cd web
npm install
npm run build
cd ..
```

3. 运行程序

```bash
go run main.go
```

## 使用说明

### 基本使用

1. 打开浏览器访问 `http://localhost:8080`（默认管理端口）
2. 点击"添加接口"创建新的 Mock 接口
3. 配置接口路径、方法、响应内容等
4. 保存后即可通过 Mock 服务端口访问

### 动态响应

在接口编辑中启用"动态响应"，编写 JavaScript 代码动态生成响应：

```javascript
// req 对象包含请求信息
const id = req.query.id || 'default';
return JSON.stringify({
  code: 0,
  message: 'success',
  data: { id: id, name: 'User ' + id }
});
```

### 条件响应

根据请求参数匹配条件返回不同响应：

- **规则匹配**：设置参数名、运算符、匹配值
- **代码判断**：编写 JavaScript 代码返回 true/false 或自定义响应

## 打包构建

### Windows 带图标打包

1. 准备图标文件

将图标文件命名为 `icon.ico` 放在 `resources` 目录下。

图标要求：
- 格式：ICO
- 推荐尺寸：256x256, 128x128, 64x64, 48x48, 32x32, 16x16

2. 创建版本信息文件

创建 `versioninfo.json`：

```json
{
  "FixedFileInfo": {
    "FileVersion": {"Major": 1, "Minor": 0, "Patch": 0, "Build": 0},
    "ProductVersion": {"Major": 1, "Minor": 0, "Patch": 0, "Build": 0}
  },
  "StringFileInfo": {
    "CompanyName": "Data Mock Tool",
    "FileDescription": "Data Mock Tool - API Mock Server",
    "FileVersion": "1.0.0.0",
    "InternalName": "data-mock-tool",
    "OriginalFilename": "data-mock-tool.exe",
    "ProductName": "Data Mock Tool",
    "ProductVersion": "1.0.0.0"
  },
  "VarFileInfo": {
    "Translation": {"LangID": "0804", "CharsetID": "04B0"}
  },
  "IconPath": "resources/icon.ico"
}
```

3. 安装 goversioninfo

```bash
go install github.com/josephspurrier/goversioninfo/cmd/goversioninfo@latest
```

4. 生成资源文件

```bash
goversioninfo -o icon.syso -icon resources/icon.ico versioninfo.json
```

5. 编译程序

```bash
go build -o data-mock-tool.exe .
```

编译后的 `data-mock-tool.exe` 将显示自定义图标。

### 使用构建脚本

项目提供了构建脚本简化打包流程：

**Windows (PowerShell)**：

```powershell
.\build.ps1
```

**Windows (CMD)**：

```cmd
build.bat
```

脚本会自动完成前端构建、资源生成和程序编译。

## 配置说明

配置文件 `mock-config.json`：

```json
{
  "mockPort": 3000,
  "adminPort": 8080,
  "interfaces": []
}
```

- `mockPort`：Mock 服务端口
- `adminPort`：管理界面端口
- `interfaces`：接口配置列表

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 开源协议

[MIT](LICENSE)