在Go语言中将结构体格式化为自定义字符串（如URL查询参数）

本文深入探讨了在Go语言中将结构体实例转换为特定字符串格式（例如URL查询参数样式）的多种方法。我们将详细介绍fmt包的格式化动词（特别是%v和%s的区别）、如何利用reflect包动态获取结构体字段及其值，以及通过实现String()方法自定义结构体的默认字符串表示。此外，还将介绍使用net/url包实现更健壮的URL参数编码。

1. 理解Go的fmt包与格式化动词

Go语言的fmt包提供了强大的格式化输出能力。在处理不同类型的数据时，选择正确的格式化动词至关重要。开发者在尝试将结构体字段值打印为字符串时，常会遇到如%!s(int=3)的问题，这通常是由于对%s和%v的误用造成的。

• %s (字符串): 期望一个字符串类型的值，或者一个可以被解释为字符串的类型（如[]byte），或者实现了String() string方法的类型。如果传入非字符串类型且未实现String()方法，fmt包会尝试将其转换为字符串，但对于int等基本类型，会产生如%!s(int=3)这样的错误提示，表明无法以字符串形式表示该整数。
• %v (默认值): 这是最通用的格式化动词。它会根据值的实际类型进行默认格式化。对于基本类型，它会直接打印其值；对于结构体，它会打印字段名和字段值。如果类型实现了String() string方法，%v会优先调用该方法。

示例代码：%s与%v的区别

package main

import (
    "fmt"
)

type Item struct {
    Limit  int
    Skip   int
    Fields string
}

func main() {
    item := Item{
        Limit:  3,
        Skip:   5,
        Fields: "Value",
    }

    fmt.Println("--- 使用 %s 格式化 ---")
    // 错误示范：使用 %s 格式化非字符串类型，会导致格式化错误
    fmt.Printf("Limit : %s\n", item.Limit) // 输出: Limit : %!s(int=3)
    fmt.Printf("Skip : %s\n", item.Skip)   // 输出: Skip : %!s(int=5)
    fmt.Printf("Fields : %s\n", item.Fields) // 输出: Fields : Value (正确，因为Fields是字符串)

    fmt.Println("\n--- 使用 %v 格式化 ---")
    // 正确示范：使用 %v 格式化任意类型，fmt包会根据类型自动选择合适的表示方式
    fmt.Printf("Limit : %v\n", item.Limit) // 输出: Limit : 3
    fmt.Printf("Skip : %v\n", item.Skip)   // 输出: Skip : 5
    fmt.Printf("Fields : %v\n", item.Fields) // 输出: Fields : Value
}

2. 将结构体转换为自定义字符串格式

我们的目标是将Item结构体转换为"Limit=3&Skip=5&Fields=Value"这样的字符串。我们可以通过几种方式实现这一目标。

立即学习“go语言免费学习笔记（深入）”；

2.1 使用reflect包动态构建字符串

reflect包是Go语言的核心特性之一，它允许程序在运行时检查类型、变量和函数，从而实现通用化的结构体处理。通过reflect包，我们可以遍历结构体的所有导出字段，获取它们的名称和值，然后拼接成目标字符串。用户可能使用了第三方库如reflections，这些库通常是对标准库reflect的封装，提供了更简洁的API。以下是使用标准库reflect实现的方法：

package main

import (
    "fmt"
    "reflect"
    "strconv"
    "strings"
)

type Item struct {
    Limit  int
    Skip   int
    Fields string
    // 未导出字段（小写字母开头）不会被反射获取
    privateField string
}

// structToQueryString 使用反射将结构体转换为查询字符串格式
func structToQueryString(s interface{}) (string, error) {
    v := reflect.ValueOf(s)
    if v.Kind() != reflect.Struct {
        return "", fmt.Errorf("input must be a struct, got %s", v.Kind())
    }

    var parts []string
    t := v.Type()

    for i := 0; i < v.NumField(); i++ {
        field := t.Field(i)
        fieldValue := v.Field(i)

        // 只处理导出字段（首字母大写）
        if !field.IsExported() {
            continue
        }

        fieldName := field.Name
        var valueStr string

        // 根据字段类型转换为字符串
        switch fieldValue.Kind() {
        case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64:
            valueStr = strconv.FormatInt(fieldValue.Int(), 10)
        case reflect.String:
            valueStr = fieldValue.String()
        case reflect.Bool:
            valueStr = strconv.FormatBool(fieldValue.