Go语言处理URL查询参数完全指南（使用net/url包解析与构建查询字符串）

什么是查询参数？

查询参数是URL中问号（?）后面的部分，通常以键值对的形式出现，多个参数之间用 & 分隔。例如：

https://example.com/search?q=go&page=2&lang=zh

其中 q=go、page=2 和 lang=zh 就是三个查询参数。

Go语言中的 url.Values 类型

net/url 包定义了一个名为 Values 的类型，它本质上是一个 map[string][]string，即每个键可以对应多个字符串值。这非常适用于处理重复参数名的情况（如 ?tag=go&tag=web）。

1. 解析查询字符串

使用 url.ParseQuery 函数可以将一个查询字符串解析为 url.Values 对象：

package mainimport (    "fmt"    "net/url")func main() {    queryStr := "name=Alice&age=30&hobby=coding&hobby=reading"    values, err := url.ParseQuery(queryStr)    if err != nil {        panic(err)    }    fmt.Println("Name:", values.Get("name"))       // Alice    fmt.Println("Age:", values.Get("age"))         // 30    fmt.Println("Hobbies:", values["hobby"])       // [coding reading]}

注意：Get(key) 方法只返回第一个值，如果需要所有值，请直接通过 values[key] 访问切片。

2. 构建查询字符串

你可以创建一个 url.Values 对象，并添加参数，然后调用 Encode() 方法生成URL安全的查询字符串：

package mainimport (    "fmt"    "net/url")func main() {    params := url.Values{}    params.Add("q", "Go语言")    params.Add("page", "1")    params.Add("tags", "tutorial")    params.Add("tags", "beginner")    queryString := params.Encode()    fmt.Println(queryString)    // 输出: page=1&q=Go%E8%AF%AD%E8%A8%80&tags=tutorial&tags=beginner}

可以看到，中文“Go语言”被自动进行了 URL编码（UTF-8 + Percent-Encoding），这是符合RFC 3986规范的安全做法。

3. 从完整URL中提取查询参数

如果你有一个完整的URL，也可以先解析整个URL，再获取其查询参数：

package mainimport (    "fmt"    "net/url")func main() {    fullURL := "https://api.example.com/data?user=john&limit=10"    u, err := url.Parse(fullURL)    if err != nil {        panic(err)    }    values := u.Query() // 返回 url.Values    fmt.Println("User:", values.Get("user")) // john    fmt.Println("Limit:", values.Get("limit")) // 10}

4. 修改并重新组装URL

你还可以修改查询参数后，重新生成完整的URL：

package mainimport (    "fmt"    "net/url")func main() {    u, _ := url.Parse("https://example.com/search?q=old")    q := u.Query()    q.Set("q", "new search")    q.Set("sort", "date")    u.RawQuery = q.Encode()    fmt.Println(u.String())    // 输出: https://example.com/search?q=new+search&sort=date}

小贴士：关于URL编码

在使用 net/url 包时，你无需手动处理 URL编码。无论是 Add、Set 还是 Encode，Go都会自动对特殊字符（如空格、中文、符号等）进行正确的编码，确保生成的URL符合标准且可被服务器正确解析。

总结

通过 net/url 包中的 Values 类型，Go语言让处理查询参数变得极其简单和安全。无论你是要解析用户请求中的参数，还是要构造API调用的URL，都可以借助这个强大的工具高效完成。

掌握这些基础操作，是学习 Go语言 Web开发 的重要一步。希望本教程能帮助你轻松上手！