Golang net/url网址解析参数编码解码-Golang-PHP中文网

Golang net/url网址解析参数编码解码

P粉602998670

发布： 2025-09-01 10:24:02

原创

854人浏览过

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

golang net/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]

登录后复制

获取切片。

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

参数编码（转义）

中文或特殊字符在 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 net/url网址解析参数编码解码的详细内容，更多请关注php中文网其它相关文章！