# http-request-util

**Repository Path**: code-duck/http-request-util

## Basic Information

- **Project Name**: http-request-util
- **Description**: HTTP请求客户端小工具
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-18
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Http Util

轻量级开发者 HTTP 请求调试工具 — curl 的可视化替代品。

基于 **Electron + Vue 3 + TypeScript** 构建的桌面应用，提供简洁直观的界面来发送 HTTP 请求、管理接口收藏，并支持批量发送与结果对比。

## 功能特性

- **HTTP 请求发送** — 支持 GET / POST / PUT / DELETE，自定义 Headers 与 Body（JSON）
- **URL 收藏管理** — 增删改查接口地址，别名命名，拖拽排序
- **批量请求** — 勾选多个 URL 一键批量发送，卡片式结果展示，支持展开/收折
- **导入导出** — 收藏列表支持 JSON 文件导入导出，方便团队共享
- **智能错误提示** — 请求失败时自动分析原因（连接拒绝、DNS 解析失败、超时等）
- **键盘快捷键** — `Ctrl+Enter` 发送、`Ctrl+S` 保存、`Ctrl+N` 新增、`Ctrl+A` 全选
- **数据持久化** — 本地 JSON 文件存储，自动备份容灾

## 技术栈

| 层级 | 技术 |
|------|------|
| 框架 | Electron 28 |
| 前端 | Vue 3 + Pinia + Element Plus |
| 构建 | electron-vite + Vite 5 |
| 语言 | TypeScript 5 |
| HTTP | Node.js 原生 http/https 模块 |
| 存储 | JSON 文件读写（Electron userData 目录） |

## 项目结构

```
request-util/
├── src/
│   ├── shared/           # 共享类型定义 + IPC 通道常量
│   ├── main/             # 主进程（IPC 处理、HTTP 客户端、数据存储）
│   ├── preload/          # 预加载脚本（contextBridge API）
│   └── renderer/         # Vue 3 渲染进程（组件、Store、组合式函数）
├── resources/            # 应用图标
├── electron.vite.config.ts
├── electron-builder.yml  # 打包配置
└── package.json
```

## 开发运行

### 环境要求

- Node.js >= 18
- npm >= 9

### 安装依赖

```bash
cd request-util
npm install
```

> 国内用户建议配置淘宝镜像加速：
>
> **方式一：通过 .npmrc 配置（推荐，所有平台通用）**
>
> 在项目根目录创建或编辑 `.npmrc` 文件：
> ```ini
> registry=https://registry.npmmirror.com
> ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
> ```
> 然后执行：
> ```bash
> npm install
> ```
>
> **方式二：命令行临时指定**
>
> macOS / Linux (bash/zsh):
> ```bash
> ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/" npm install
> ```
>
> Windows (CMD):
> ```cmd
> set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ && npm install
> ```
>
> Windows (PowerShell):
> ```powershell
> $env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"; npm install
> ```

### 开发模式（热更新）

```bash
npm run dev
```

启动后自动打开 Electron 窗口，渲染进程代码修改热更新，主进程修改自动重启。

### 生产构建

```bash
npm run build          # 构建到 out/ 目录
```

### 应用打包

```bash
npm run pack           # 快速打包（未压缩）
npm run dist:mac       # macOS DMG + ZIP
npm run dist:win       # Windows NSIS 安装包
npm run dist:linux     # Linux AppImage + DEB
```

打包产物输出到 `dist/` 目录。

## 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+Enter` / `⌘+Enter` | 发送请求 |
| `Ctrl+S` / `⌘+S` | 保存当前请求到收藏列表 |
| `Ctrl+N` / `⌘+N` | 新增空白收藏项 |
| `Ctrl+A` / `⌘+A` | 全选收藏列表 |
| 双击列表项 | 选中并立即发送请求 |

## 数据存储

所有收藏数据存储在 Electron 标准用户数据目录下的 `data.json`：

- **macOS**: `~/Library/Application Support/http-util/data.json`
- **Windows**: `%APPDATA%/http-util/data.json`
- **Linux**: `~/.config/http-util/data.json`

写入前自动备份到 `data.json.bak`，读取失败时自动从备份恢复。

## License

MIT