在Go语言开发中，和服务端交互或抓取网页时往往要先处理一串URL文本。net/url作为标准库的一部分，专门用来解析、构造和编码URL，能够把复杂的字符串转成清晰的结构体，省去自己写正则或字符串切割的麻烦。
一、net/url包的基本结构
net/url包最核心的类型是url.URL，它对应RFC 3986中定义的统一资源定位符。一个URL通常被拆成协议、主机、路径、查询参数等部分，Go通过结构体字段把这些内容暴露出来，让开发者可以直接读取。
当我们调用url.Parse方法时，函数会返回指向url.URL的指针以及可能的错误。如果传入的字符串不符合基本格式，比如缺少协议头，Parse会返回错误，因此实际项目中一定要处理这个返回值，不能假设解析永远成功。
package main
import (
"fmt"
"net/url"
)
func main() {
raw := "https://ippipp.com:8080/path/to/page?name=张三&age=20"
// 解析URL字符串
u, err := url.Parse(raw)
if err != nil {
fmt.Println("解析失败:", err)
return
}
fmt.Println("Scheme:", u.Scheme)
fmt.Println("Host:", u.Host)
fmt.Println("Path:", u.Path)
}
二、解析查询参数Query
URL里最常见也最容易出错的就是查询参数部分。net/url提供了url.Values类型，它本质上是map[string][]string，用来表示一个键可能对应多个值的情况。通过URL对象的Query方法，可以直接拿到解析好的参数集合。
需要注意，Query方法每次调用都会重新解析RawQuery字段，如果在循环里频繁使用，可以考虑先保存结果。另外，中文或特殊符号在URL中会被编码，Query方法会自动解码，不需要手动处理百分号转义。
package main
import (
"fmt"
"net/url"
)
func main() {
raw := "https://ipipp.com/search?keyword=golang&page=2&tag=net_url"
u, _ := url.Parse(raw)
// 获取查询参数集合
values := u.Query()
fmt.Println("keyword:", values.Get("keyword"))
fmt.Println("page:", values.Get("page"))
// 遍历所有参数
for k, v := range values {
fmt.Printf("%s => %vn", k, v)
}
}
三、构造与编码URL
除了解析，net/url也能反过来构造URL。我们可以创建一个url.URL实例，设置各个字段，然后调用String方法生成合规的字符串。对于查询参数，使用url.Values的Encode方法可以完成键值对的正确编码，避免空格和中文破坏请求。
在拼接外部接口地址时，手动用字符串加号连接很容易漏掉编码，导致服务端收到乱码。使用url.Values和url.URL配合，既能保证可读性，也能减少线上故障。下面的例子演示了如何安全地构造带参数的请求地址。
package main
import (
"fmt"
"net/url"
)
func main() {
base := &url.URL{
Scheme: "https",
Host: "ipipp.com",
Path: "/api/list",
}
// 构造查询参数
params := url.Values{}
params.Set("category", "tech")
params.Set("q", "Go 编程")
base.RawQuery = params.Encode()
fmt.Println(base.String())
}
四、常见误区与注意事项
很多初学者会把url.Parse和url.ParseRequestURI搞混。前者允许相对路径并更宽松，后者严格要求有绝对路径且用于HTTP请求行解析。如果在网关或代理里处理原始请求，选错函数会导致合法请求被误判为错误。
另一个坑是特殊字符转义。net/url默认按照RFC规范编码，但某些旧系统期望空格写成加号而不是百分号二十。此时可以手动替换，或者确认服务端兼容标准编码，避免两边不一致引发接口异常。
| 场景 | 推荐函数 | 说明 |
|---|---|---|
| 解析浏览器地址 | url.Parse | 支持相对URL，容错较高 |
| 解析HTTP请求行 | url.ParseRequestURI | 必须绝对路径，更严格 |
| 生成查询串 | url.Values.Encode | 自动处理编码 |
五、总结
net/url是Go标准库中非常实用的工具，掌握它能让URL处理变得简单且可靠。从解析主机路径，到读取多重查询参数，再到安全构造请求，都可以通过几个清晰的方法完成。
在真实业务里，建议把所有外部URL都走net/url处理，不要手拼字符串。这样既能避开编码坑，也能让后续维护的人一眼看懂数据从哪里来、要到哪里去。