Go语言中URL编码与解码的推荐实践

package main

import (
    "fmt"
    "net/url"
)

func main() {
    // 1. 解析一个基础URL
    // url.Parse 会自动处理URL字符串的解码，并将其分解为URL结构体的各个部分。
    baseUrl, err := url.Parse("http://www.example.com")
    if err != nil {
        // 错误处理是必不可少的
        panic("解析基础URL失败: " + err.Error())
    }

    // 2. 构建URL路径
    // 直接修改 Path 字段，添加路径段。
    // net/url 包在最终生成URL时，会自动对Path中的特殊字符进行编码。
    baseUrl.Path += "/some/path/or/other_with_funny_characters?_or_not/"

    // 3. 构建查询参数
    // 使用 url.Values 类型来管理查询参数，它是一个 map[string][]string。
    parameters := url.Values{}
    parameters.Add("hello", "42")         // 添加第一个 hello 参数
    parameters.Add("hello", "54")         // 添加第二个 hello 参数，同一个键可以有多个值
    parameters.Add("vegetable", "potato") // 添加 vegetable 参数

    // 4. 将编码后的查询参数赋值给 URL 的 RawQuery 字段
    // parameters.Encode() 会对键和值进行URL编码，并用 & 连接。
    baseUrl.RawQuery = parameters.Encode()

    // 5. 获取最终编码后的URL字符串
    // baseUrl.String() 方法会将 URL 结构体的所有部分组合起来，
    // 并对需要编码的部分（如路径、查询参数）进行标准编码。
    encodedUrl := baseUrl.String()
    fmt.Printf("编码后的URL是: %q\n", encodedUrl)

    // 6. 演示解码：使用 url.Parse() 解析编码后的URL
    parsedUrl, err := url.Parse(encodedUrl)
    if err != nil {
        panic("解析编码URL失败: " + err.Error())
    }

    fmt.Printf("\n解码后的URL组件:\n")
    fmt.Printf("Scheme: %s\n", parsedUrl.Scheme)
    fmt.Printf("Host: %s\n", parsedUrl.Host)
    fmt.Printf("Path: %s (已解码)\n", parsedUrl.Path)
    // parsedUrl.Query() 会返回一个 url.Values 类型，其中的值已经解码。
    fmt.Printf("Query 参数: %v (已解码)\n", parsedUrl.Query())
    fmt.Printf("RawQuery: %s (原始编码)\n", parsedUrl.RawQuery)
}

编码后的URL是: "http://www.example.com/some/path/or/other_with_funny_characters%3F_or_not/?hello=42&hello=54&vegetable=potato"

解码后的URL组件:
Scheme: http
Host: www.example.com
Path: /some/path/or/other_with_funny_characters?_or_not/ (已解码)
Query 参数: map[hello:[42 54] vegetable:[potato]] (已解码)
RawQuery: hello=42&hello=54&vegetable=potato (原始编码)