url.Parse 从不返回 nil，失败时仍返回 *url.URL（部分字段为零值）和非 nil error；必须检查 err != nil 而非指针判空。
URL 解析失败时 url.Parse 返回 nil 还是 error？
它从不返回 nil，但会返回一个非空的 *url.URL 即使解析出错——比如 url.Parse("http://") 会返回一个 Host 为空的 URL 结构体，而错误只在第二个返回值中体现。必须检查 err != nil，不能靠判空指针。
-
url.Parse成功时返回有效结构体 +nil错误；失败时仍返回结构体（部分字段为零值）+ 非nil错误 - 常见误用：
u, _ := url.Parse("htp://example.com") // 忽略 err，后续 u.Scheme == "" 导致逻辑崩溃 - 安全写法：
u, err := url.Parse("https://api.example.com/v1?x=1&y=2") if err != nil { log.Fatal(err) // 或返回、返回默认值等 }
如何安全提取 query 参数（含中文和特殊字符）
url.Query 字段是已解码后的 url.Values，但直接访问 u.RawQuery 是原始未解码字符串。中文参数如 ?name=%E4%BD%A0%E5%A5%BD，用 u.Query().Get("name") 自动解码为 "你好"；若手动处理 RawQuery，需调用 url.ParseQuery 并自行处理错误。
-
u.Query().Get("key")：自动解码，推荐用于常规取值 -
u.Query().Set("k", "v")：自动编码，适合构造新 query - 手动解析 raw query 时注意：
values, err := url.ParseQuery(u.RawQuery) if err != nil { /* 处理 malformed query */ } - 避免对
RawQuery直接做字符串切割或正则匹配——编码字符（如%20）会被拆断
url.URL 的 String() 方法是否总是生成合法 URL？
不是。当 u.Opaque 非空（如 url.Parse("mailto:test@example.com")）时，String() 会忽略 Host/Path 等字段，只输出 Opaque 内容；另外，如果 u.Scheme 为空但 u.Opaque 也为空，String() 可能返回不带 scheme 的路径，不符合标准 URL 格式。
- 生成可对外使用的 URL 应确保：
u.Scheme != ""且u.Host != ""（对 http/https 而言） - 构造后建议再解析一次验证：
u2, err := url.Parse(u.String()) if err != nil || u2.Scheme == "" || u2.Host == "" { /* 不合法 */ } - 拼接路径时别直接字符串加
/，用u.ResolveReference(&url.URL{Path: "/api"})
修改 URL 后如何保留原有 query 参数并添加新参数？
直接改 u.RawQuery 会破坏编码，应操作 u.Query() 返回的 url.Values，再赋回 u.RawQuery。
立即学习“go语言免费学习笔记（深入）”；
- 正确方式：
q := u.Query() q.Set("t", strconv.FormatInt(time.Now().Unix(), 10)) u.RawQuery = q.Encode() - 不要：
u.RawQuery += "&t=..."—— 中文或特殊字符会乱码，且可能重复编码 - 删除参数：
q.Del("token")，然后u.RawQuery = q.Encode() - 注意：
url.Values是 map 类型，遍历时顺序不保证；如需稳定顺序，得自己排序后构建
有些 URL 字段看似可写（比如 u.Path），但改完不调用 u.String() 或没重设 RawQuery 就直接使用，query 会丢失。net/url 包的字段不是全联动的，修改行为要严格按文档预期来。
