Go语言中URL的完整编码与解码：net/url包的最佳实践

package main

import (
    "fmt"
    "net/url"
)

func main() {
    // 1. 解析基础URL
    // url.Parse函数用于解析一个URL字符串并返回一个*url.URL对象。
    // 这是处理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查询参数
    // url.Values是一个map[string][]string类型，专门用于管理URL的查询参数。
    // 它提供了Add、Set、Get等方法，方便地操作参数。
    parameters := url.Values{}
    parameters.Add("hello", "42")         // 添加参数，支持同名参数多个值
    parameters.Add("hello", "54")
    parameters.Add("vegetable", "potato") // 添加另一个参数
    parameters.Add("special_char", "你好 Go!") // 包含非ASCII字符

    // 4. 将查询参数编码并赋值给URL的RawQuery字段
    // parameters.Encode()方法会将url.Values中的所有参数进行URL编码，
    // 并以"key1=value1&key2=value2"的格式返回字符串。
    // 这个字符串随后被赋给url.URL的RawQuery字段。
    baseUrl.RawQuery = parameters.Encode()

    // 5. 生成最终的编码URL字符串
    // 调用url.URL的String()方法会根据url.URL结构体中的所有字段，
    // 自动进行适当的URL编码，并拼接成一个完整的URL字符串。
    // 这是实现“完整URL编码”的关键步骤。
    fmt.Printf("编码后的URL是: %q\n", baseUrl.String())

    // 6. 演示解码（从一个已编码的URL字符串解析）
    fmt.Println("\n--- 解码示例 ---")
    encodedURLString := "http://www.example.com/some/path/or/other_with_funny_characters%3F_or_not/?hello=42&hello=54&special_char=%E4%BD%A0%E5%A5%BD+Go!&vegetable=potato"
    decodedUrl, err := url.Parse(encodedURLString)
    if err != nil {
        panic("解析编码URL失败: " + err.Error())
    }

    fmt.Printf("原始编码URL: %q\n", encodedURLString)
    fmt.Printf("解析后的路径: %q\n", decodedUrl.Path)
    fmt.Printf("解析后的查询参数: %v\n", decodedUrl.Query()) // Query()方法返回url.Values，其中值已自动解码
    fmt.Printf("获取 'special_char' 参数: %q\n", decodedUrl.Query().Get("special_char"))
}

编码后的URL是: "http://www.example.com/some/path/or/other_with_funny_characters%3F_or_not/?hello=42&hello=54&special_char=%E4%BD%A0%E5%A5%BD+Go!&vegetable=potato"

--- 解码示例 ---
原始编码URL: "http://www.example.com/some/path/or/other_with_funny_characters%3F_or_not/?hello=42&hello=54&special_char=%E4%BD%A0%E5%A5%BD+Go!&vegetable=potato"
解析后的路径: "/some/path/or/other_with_funny_characters?_or_not/"
解析后的查询参数: map[hello:[42 54] special_char:[你好 Go!] vegetable:[potato]]
获取 'special_char' 参数: "你好 Go!"