必须检查 url.Parse 的错误，它不 panic 而是返回 nil 和 error；推荐用 url.ParseRequestURI 校验绝对 URI；取参数用 u.Query() 自动解码，拼路径用 url.JoinPath 或 u.ResolveReference。
直接用 url.Parse 解析字符串，但必须检查错误
Go 的 net/url 包里最常用的是 url.Parse，它把字符串转成 *url.URL 结构体。但这个函数不 panic，出错只返回 nil 和 error —— 很多人忽略错误检查，结果后续调用 u.Host 或 u.Path 时 panic。
- 必须判断
err != nil，不能只看返回值是否非 nil - 常见错误：传入空字符串、缺少协议（如
"example.com"）、含非法字符（如未 编码 的空格） -
url.Parse不会自动补http://，"example.com"会解析失败
u, err := url.Parse("https://user:pass@example.com:8080/path?a=1#frag") if err != nil {log.Fatal(err) // 别跳过这步 } fmt.Println(u.Scheme) // "https" fmt.Println(u.User.Username()) // "user" fmt.Println(u.Port()) // "8080" url.ParseRequestURI 更严格，适合 HTTP 请求场景
如果目标是解析客户端发来的原始请求 URI（比如 GET /api/v1?x=1），或者你明确只要绝对 URI（带 scheme），就该用 url.ParseRequestURI。它拒绝相对路径和无 scheme 的输入，比 url.Parse 少一些“宽容”，更适合校验。
-
url.ParseRequestURI("/path?k=v")返回 error（缺 scheme） -
url.ParseRequestURI("https://a.b/c")成功 - HTTP 服务器中读取
r.RequestURI后，应优先用它而不是url.Parse - 注意：
ParseRequestURI不处理 fragment（#……），它会被丢弃
从 URL 中安全提取查询参数用 u.Query()
u.RawQuery 是原始字符串（如 "a=1&b=%20"），而 u.Query() 返回 url.Values，是自动解码后的 map[string][]string。这是最常用的取参方式，但要注意几个边界：
- 同一个 key 出现多次（
?a=1&a=2），u.Query().Get("a")只返回第一个值（"1"），要用u.Query()["a"]拿全部 - 值含 % 编码（如
%20）会被自动解码，不需要手动url.QueryUnescape - 如果查询串为空或不存在，
u.Query()仍返回空 map，不会 panic
u, _ := url.Parse("https://x.y/z?q=hello%20world&tag=go&tag=web") vals := u.Query() fmt.Println(vals.Get("q")) // "hello world" fmt.Println(vals["tag"]) // ["go" "web"] fmt.Println(vals.Get("missing")) // ""（空字符串）拼接 URL 时别手拼字符串，用 url.JoinPath 或 u.ResolveReference
手动拼 base + "/" + path 容易出错：重复斜杠、缺失分隔、路径含 .. 未清理、参数未编码。Go 1.19+ 提供了 url.JoinPath，专为路径拼接设计；已有 *url.URL 实例时，用 ResolveReference 更可靠。
立即学习“go 语言免费学习笔记（深入）”；
-
url.JoinPath("https://a.b", "c", "d")→"https://a.b/c/d" -
url.JoinPath("https://a.b/c/", "../d")→"https://a.b/d"（自动清理） -
u.ResolveReference(&url.URL{Path: "sub/"})基于原 URL 解析相对路径 - 拼查询参数？还是走
u.Query().Set/ Add再赋回u.RawQuery
手动拼接 RawQuery 或 Fragment 时，记得用 url.QueryEscape 或 url.PathEscape 编码值，否则特殊字符会破坏结构。
