GolangURL参数编码解码详解

今日不肯埋头，明日何以抬头！每日一句努力自己的话哈哈~哈喽，今天我将给大家带来一篇《Golang URL参数编码解码解析》，主要内容是讲解等等，感兴趣的朋友可以收藏或者有更好的建议在评论提出，我都会认真看的！大家一起进步，一起学习！

Go语言中使用net/url包解析和处理URL及查询参数，通过url.Parse解析URL各部分，url.Query获取参数键值对，url.Values支持多值和编码，QueryEscape对字符串编码，Encode自动编码参数，QueryUnescape解码，结合url.URL和Values可安全构造带参数的URL。

在 Go 语言中，net/url 包提供了处理 URL 和查询参数的强大功能，包括解析、编码、解码等操作。在实际开发中，经常需要处理带参数的网址，比如从请求中提取查询参数，或构造一个带编码参数的 URL。下面详细介绍如何使用 net/url 进行网址解析和参数的编码解码。

解析 URL

使用 url.Parse() 可以将一个完整的 URL 字符串解析为 *url.URL 结构体，便于访问各个部分（如 scheme、host、path、query 等）。

package main

import (
    "fmt"
    "net/url"
)

func main() {
    u, err := url.Parse("https://example.com:8080/path/to/page?name=张三&age=25&city=北京")
    if err != nil {
        panic(err)
    }

    fmt.Println("Scheme:", u.Scheme) // https
    fmt.Println("Host:", u.Host)     // example.com:8080
    fmt.Println("Path:", u.Path)     // /path/to/page
    fmt.Println("Query:", u.RawQuery) // name=%E5%BC%A0%E4%B8%89&age=25&city=%E5%8C%97%E4%BA%AC
}

解析查询参数

通过 url.ParseQuery() 或直接使用 URL.Query() 方法，可以获取查询参数的键值对。返回的是 url.Values 类型，本质是 map[string][]string，支持多值参数。

    query := u.Query()
    fmt.Println("name =", query.Get("name")) // 张三
    fmt.Println("age =", query.Get("age"))   // 25
    fmt.Println("city =", query.Get("city")) // 北京

    // 获取所有值（包括多个同名参数）
    fmt.Println("All names:", query["name"]) // [张三]

注意： Get(key) 只返回第一个值，若参数可能有多个值，应使用 query[key] 获取切片。

参数编码（转义）

中文或特殊字符在 URL 中必须进行 URL 编码（百分号编码）。Go 提供了 url.QueryEscape() 对单个字符串进行编码，url.Values.Encode() 对整个参数集合编码。

    name := "李四"
    escaped := url.QueryEscape(name)
    fmt.Println(escaped) // %E6%9D%8E%E5%9B%9B

    // 构造多个参数并编码
    params := url.Values{}
    params.Add("name", "王五")
    params.Add("city", "上海")
    params.Add("tag", "go")
    params.Add("tag", "web") // 多值

    fmt.Println(params.Encode()) 
    // 输出: city=%E4%B8%8A%E6%B5%B7&name=%E7%8E%8B%E4%BA%94&tag=go&tag=web

QueryEscape 会处理空格为 +，这是符合 application/x-www-form-urlencoded 格式的。

参数解码

使用 url.QueryUnescape() 可将编码后的字符串还原为原始内容。

    encoded := "%E5%8C%97%E4%BA%AC"
    decoded, err := url.QueryUnescape(encoded)
    if err != nil {
        panic(err)
    }
    fmt.Println(decoded) // 北京

在使用 url.Values 时，Get() 方法返回的已经是自动解码后的字符串，无需手动调用 QueryUnescape。

构造带参数的 URL

结合 url.URL 和 url.Values 可以安全地构造带编码参数的 URL。

    u := &url.URL{
        Scheme: "https",
        Host:   "api.example.com",
        Path:   "/search",
    }

    params := url.Values{}
    params.Set("q", "golang 教程")
    params.Set("page", "1")

    u.RawQuery = params.Encode()
    fmt.Println(u.String()) 
    // https://api.example.com/search?q=golang+%E6%95%99%E7%A8%8B&page=1

基本上就这些。掌握 url.Parse、Query()、Values、QueryEscape 和 Encode 就能应对大多数 Web 开发中的 URL 处理需求。编码自动处理中文和特殊字符，避免手动拼接出错。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~