Go语言用net/url包解析URL和查询参数:url.Parse()返回*url.URL结构体,可直接访问Scheme、Hostname()、Port()、Path、RawQuery等字段;u.Query()自动解码并返回url.Values(map[string][]string),支持Get、Add、Set等操作;构造参数需用url.Values{}.Encode()写回RawQuery。

Go语言中解析URL和查询参数非常简单,主要依靠标准库 net/url 包。它能安全地拆解URL结构、提取协议、主机、路径、端口,还能自动解码并遍历查询参数(query string),无需手动字符串分割或URL解码。
解析完整URL:获取协议、主机、路径等字段
使用 url.Parse() 可将字符串转为 *url.URL 结构体,之后直接访问各字段:
-
u.Scheme:协议名,如"https" -
u.Host:主机+端口(如"example.com:8080"),不含协议和路径 -
u.Hostname():仅主机名(自动剥离端口) -
u.Port():仅端口号(若存在) -
u.Path:路径部分(如"/api/users") -
u.RawQuery:原始查询字符串(未解码,如"name=%E5%BC%A0%E4%B8%89&age=25")
示例:
u, err := url.Parse("https://api.example.com:8080/v1/search?q=go&lang=zh-CN")if err != nil { log.Fatal(err) }
fmt.Println(u.Scheme) // "https"
fmt.Println(u.Hostname()) // "api.example.com"
fmt.Println(u.Port()) // "8080"
fmt.Println(u.Path) // "/v1/search"
提取并解码查询参数:用 u.Query() 获取 map[string][]string
u.Query() 返回一个 url.Values 类型(本质是 map[string][]string),它已自动对键和值完成 URL 解码,支持重复键(如 a=1&a=2):
立即学习“go语言免费学习笔记(深入)”;
-
vals.Get("key"):取第一个值(常用,返回string) -
vals["key"]:取所有值(返回[]string) -
vals.Add("k", "v"):追加键值(允许重复) -
vals.Set("k", "v"):覆盖设置(只保留一个)
示例:
vals := u.Query()fmt.Println(vals.Get("q")) // "go"
fmt.Println(vals["lang"]) // ["zh-CN"]
fmt.Println(vals.Get("notexist")) // ""(空字符串)
手动构造或修改查询参数
可新建 url.Values,再通过 u.RawQuery = vals.Encode() 写回URL:
- 先用
url.Values{}初始化空映射 - 用
Add或Set添加参数 - 调用
.Encode()得到编码后的查询字符串 - 赋值给
u.RawQuery,再用u.String()输出完整URL
示例:
vals := url.Values{}vals.Set("page", "2")
vals.Add("sort", "name")
vals.Add("sort", "time")
u.RawQuery = vals.Encode()
fmt.Println(u.String()) // ...?page=2&sort=name&sort=time
注意边界情况:无效URL、空查询、特殊字符
url.Parse() 遇到格式错误会返回非 nil error,必须检查;空查询(无 ?)时 u.RawQuery 为空字符串,u.Query() 仍返回空 url.Values;路径中含 % 编码时,u.Path 是未解码的原始路径(如 "/user/%E5%BC%A0"),如需解码可用 url.PathUnescape(u.Path)。










