---
sidebar_label: "性能优化"
title: "性能优化 - CyberGo HTTPC | 预设与并发"
description: "HTTPC 性能优化指南：Default/Secure/Performance/Minimal 四种预设对比与场景选型、基于预设微调连接池与超时参数、Result 生命周期自动管理减少 GC 压力、高并发请求模式与性能反模式分析与优化建议。"
sidebar_position: 1
---

# 性能优化

## 预设配置对比

| 指标 | Default | Secure | Performance | Minimal |
|------|---------|--------|-------------|---------|
| Request 超时 | 180s | 15s | 60s | 180s |
| MaxIdleConns | 50 | 20 | 100 | 10 |
| MaxConnsPerHost | 10 | 5 | 20 | 2 |
| MaxRetries | 3 | 1 | 3 | 0 |
| MaxResponseBodySize | 10MB | 5MB | 50MB | 1MB |
| HTTP/2 | 开启 | 开启 | 开启 | 开启 |
| Cookies | 关闭 | 关闭 | 开启 | 关闭 |
| SSRF 防护 | 开启 | 开启 | 开启 | 开启 |
| FollowRedirects | 开启 | 关闭 | 开启 | 关闭 |

## 场景选型

| 场景 | 推荐预设 | 调整建议 |
|------|----------|----------|
| 通用 Web 服务 | Default | - |
| 处理用户提供的 URL | Secure | - |
| 内部微服务高并发 | Performance | 调大 MaxIdleConns |
| 一次性脚本 | Minimal | - |
| 文件下载服务 | Performance | 增大 MaxResponseBodySize |
| 金融/医疗 API | Secure + 自定义 | 增加审计中间件 |

```go
// 高吞吐场景
client, _ := httpc.New(httpc.PerformanceConfig())

// 在预设基础上微调
cfg := httpc.PerformanceConfig()
cfg.Timeouts.Request = 120 * time.Second
cfg.Connection.MaxIdleConns = 200
client, _ := httpc.New(cfg)
```

## 对象池复用

HTTPC 内部对引擎响应对象与字符串构建器复用 sync.Pool，减少 GC 压力；Result 则每次请求新建、由 GC 自动回收：

```go
result, err := client.Get(url)
if err != nil {
    return err
}
// Result 每次请求新建，GC 自动回收，无需手动释放
```

:::tip
高并发场景中，对象池复用可显著减少 GC 压力。
:::

## 性能反模式

| 反模式 | 原因 | 正确做法 |
|--------|------|----------|
| 每个请求创建客户端 | 连接无法复用 | 全局复用客户端 |
| 过大 MaxResponseBodySize | 内存占用 | 合理设置限制 |
| 热路径中用 result.String() | 字符串构建开销 | 直接用 Body() |

## 下一步

- [连接池与代理](./connection-pool) — 连接池参数选择、代理和 DoH 配置
- [错误处理](./error-handling) — 超时分层策略
- [安全概述](../security/) — 安全与性能的平衡