go语言net/url库提供安全高效的URL解析,核心是url.Parse()返回*url.URL对象,支持各字段访问与修改;需检查错误、区分RawQuery与Query()解码差异,并用ResolveReference处理相对路径。

Go语言标准库 net/url 提供了完整、安全、高效的URL解析能力,无需第三方依赖。核心是 url.Parse() 函数,它能将字符串解析为结构化的 *url.URL 对象,支持 scheme、host、path、query、fragment 等各部分的独立访问和修改。
基础解析:用 url.Parse() 拆解 URL
传入合法 URL 字符串,返回指针和错误。注意:必须检查 err 是否为 nil,否则可能 panic 或逻辑出错。
u, err := url.Parse("https://user:pass@github.com:8080/go/net?name=go&v=1.23#top")- 成功后可直接访问字段:
u.Scheme(”https”)、u.User.Username()(”user”)、u.Host(”github.com:8080″)、u.Path(”/go/net”)、u.RawQuery(”name=go&v=1.23″)、u.Fragment(”top”) - 若只需 host 和 port,可用
u.Hostname()和u.Port()分离(自动处理默认端口)
安全提取查询参数:用 u.Query() 处理 query String
u.Query() 返回 url.Values(本质是 map[string][]string),已自动解码,适合读取参数值。
values := u.Query()- 获取单值(取第一个):
values.Get("name")→ “go” - 获取所有同名值:
values["v"]→[]string{"1.23"} - 添加参数:
values.Set("debug", "true");再赋回:u.RawQuery = values.Encode()
构造与拼接 URL:用 url.URL 结构体反向生成
可手动初始化 url.URL,或基于已有 URL 修改字段后调用 u.String() 输出完整字符串。
立即学习“go语言免费学习笔记(深入)”;
- 新建空结构:
u := &url.URL{Scheme: "https", Host: "api.example.com", Path: "/v1/users"} - 设置查询参数:
u.RawQuery = url.Values{"id": []string{"123"}, "format": []string{"json"}}.Encode() - 拼接路径(避免双斜杠):
u.Path = path.Join(u.Path, "profile")(需导入path包) - 最终地址:
u.String()→ “https://api.example.com/v1/users/profile?id=123&format=json”
处理相对 URL:用 u.ResolveReference()
当遇到相对路径(如 "./detail?id=2" 或 "../login"),可用基准 URL 解析成绝对地址。
base, _ := url.Parse("https://site.com/a/b/c")rel, _ := url.Parse("./detail?id=2")-
abs := base.ResolveReference(rel)→ “https://site.com/a/b/detail?id=2″ - 这对爬虫、html 链接补全、API 路由跳转很实用
基本上就这些。net/url 设计简洁,覆盖绝大多数 Web 场景,关键是要区分 RawQuery(原始未解码)和 Query()(自动解码 map),以及注意 ResolveReference 的基准逻辑。不复杂但容易忽略细节。