resty for Go：强大而优雅的 HTTP 客户端

在 Go 语言的世界里，有许多用于处理 HTTP 请求的库。标准库 net/http 提供了基础功能，但在实际项目中，我们往往需要更便捷、功能更强大的工具。resty 库正是为此而生——它让开发者能够以简洁、可读性强的代码，轻松驾驭各种 HTTP 请求场景。

Resty 被定位为“受 Ruby 的 RestClient 启发的 Go REST API 客户端”。它提供了流畅的链式调用接口、自动 JSON 处理、内置重试机制、超时控制、中间件等丰富功能。凭借其优雅的架构，resty 让你能用极简的代码与任何 HTTP 服务交互——无论是简单的 GET 请求，还是复杂的多步骤 API 集成。

为什么要用 resty 替代标准 net/http？首先，它大幅减少了样板代码。你无需手动构建请求结构、设置请求头、解析 JSON 响应。其次，resty 为 Cookie 管理、身份认证、代理设置和文件上传提供了便捷的抽象层。最后，该库维护活跃、文档完善，并被数千个生产项目采用。这使得 resty 成为 Go 生态中 HTTP 客户端的最佳选择之一。

安装

安装 resty 使用 Go 标准的依赖管理方式——通过 go get 命令：

go get -u github.com/go-resty/resty/v2

执行此命令后，该库将被添加到你的 go.mod 文件中。请确保你使用的 Go 版本为 1.16 或更高，以支持模块功能。

在你的代码中，导入方式如下：

import "github.com/go-resty/resty/v2"

快速上手

让我们从一个最小可运行示例开始——向公共 API 发送 GET 请求并输出结果：

package main

import (
    "fmt"
    "github.com/go-resty/resty/v2"
)

func main() {
    // 创建客户端
    client := resty.New()

    // 执行 GET 请求
    resp, err := client.R().
        SetHeader("Accept", "application/json").
        Get("https://jsonplaceholder.typicode.com/posts/1")

    if err != nil {
        fmt.Println("错误:", err)
        return
    }

    fmt.Println("状态码:", resp.StatusCode())
    fmt.Println("响应体:", resp.String())
}

这个示例展示了 resty 的核心特性——链式调用接口。我们创建客户端，通过 R() 方法新建请求，设置请求头，然后执行 GET。所有调用串联在一起，使代码极具可读性。

核心方法与函数

下面介绍 resty 的 10 个关键方法，它们能覆盖 90% 的 HTTP 开发需求。

1. resty.New()

函数签名： func New() *Client

功能： 创建一个带有默认设置的新 HTTP 客户端实例。这是所有操作的起点。

client := resty.New()
// 现在 client 已准备好使用

2. Client.R()

函数签名： func (c *Client) R() *Request

功能： 创建一个新的请求对象。所有用于配置请求的方法（请求头、请求体、参数）都在此对象上调用。

request := client.R()
request.SetHeader("Content-Type", "application/json")
// ... 后续的请求操作

3. Request.Get(url)

函数签名： func (r *Request) Get(url string) (*Response, error)

功能： 向指定 URL 发送 HTTP GET 请求。返回响应对象和错误信息。