17370845950

必须检查 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 编码值，否则特殊字符会破坏结构。