使用net/url可高效解析和构造URL。通过url.Parse解析字符串为*url.URL对象,访问Scheme、Host、Path、RawQuery、Fragment等字段;利用u.Query()处理查询参数;构造URL时初始化结构体并设置Query参数后调用String();合并相对路径可用base.ResolveReference;参数转义推荐QueryEscape/PathEscape或Query().Set避免手动拼接,确保编码正确。

Go语言中使用net/url包可以高效地解析和构造URL。无论是处理用户输入的链接、构建API请求地址,还是从完整URL中提取协议、主机、路径或查询参数,net/url都提供了清晰且安全的接口。下面详细介绍其核心用法与常见实践。
解析URL:Parse与URL结构体字段
使用url.Parse()可将字符串转换为*url.URL对象,便于访问各组成部分。
例如:
u, err := url.Parse("https://user:pass@example.com:8080/path?k=v#frag")- 成功后可通过
u.Scheme获取https -
u.User包含用户名密码(如user:pass) -
u.Host返回example.com:8080,可用strings.Split(u.Host, ":")分离端口 -
u.Path是/path -
u.RawQuery为k=v,而u.Query()返回一个map[string][]string类型值,方便读取参数 -
u.Fragment对应锚点frag
注意:若URL缺少协议前缀(如http://),Parse可能失败或产生意外结果,必要时可手动补全。
立即学习“go语言免费学习笔记(深入)”;
构造URL:组合Scheme、Host、Path与Query
通过初始化url.URL结构体并调用String()方法可生成标准格式的URL。
常见做法:
- 声明结构体:
u := &url.URL{Scheme: "https", Host: "api.example.com", Path: "/v1/users"} - 添加查询参数:
q := u.Query(); q.Set("id", "123"); q.Add("sort", "asc"); u.RawQuery = q.Encode() - 最终调用
u.String()输出完整链接:https://api.example.com/v1/users?id=123&sort=asc
Encode()会自动对特殊字符进行百分号编码,确保URL合法性。
处理相对路径与基础URL合并
当遇到相对路径(如/api/data)时,可基于一个基础URL进行解析合并。
使用base.Parse()配合相对路径字符串:
base, _ := url.Parse("https://host.com/prefix/")rel, _ := url.Parse("/api/list")merged := base.ResolveReference(rel)-
merged.String()得到https://host.com/api/list
这种机制在重定向、链接补全等场景非常实用。
转义与解码:QueryEscape与PathEscape
手动拼接URL时,需对参数值做安全编码。
-
url.QueryEscape("hello world@go")→ hello+world%40go(适用于查询参数) -
url.PathEscape("a/b/c")→ a%2Fb%2Fc(保留斜杠编码行为一致) - 反向解码使用
url.QueryUnescape()即可还原原始内容
建议优先使用Query().Set()方式添加参数,避免手动拼接导致编码遗漏。
基本上就这些。掌握Parse、Query操作、结构体构建和转义函数,就能灵活应对大多数URL处理需求。net/url设计简洁,配合标准库其他模块(如net/http),能快速实现客户端请求构造或服务端路由解析逻辑。










