url.ParseQuery解析查询字符串为map[string][]string，自动解码、处理重复key和空值；修改参数应先转url.Values再Encode，避免手动拼接RawQuery导致双重编码或乱码。
URL查询参数怎么用 url.ParseQuery 解析？
Go 标准库不直接在 url.URL 结构体上暴露“解析后参数映射”，必须手动调用 url.ParseQuery 才能得到 map[string][]string。这是最常被忽略的第一步——很多人误以为 u.RawQuery 或 u.Query() 返回的就是已解析结果，其实 u.Query() 内部就调用了 ParseQuery，但返回的是只读副本。
正确做法是：
- 先用
url.Parse得到*url.URL - 再对
RawQuery调用url.ParseQuery（或直接用u.Query()，它更安全） -
url.ParseQuery会自动处理 URL 编码、重复 key、空值等，比如a=1&a=&b=2→map[string][]string{"a": {"1", ""}, "b": {"2"}}
怎么安全修改查询参数并重建 URL？
直接改 url.URL{RawQuery: "..."} 容易出错：编码未处理、键值顺序丢失、重复参数逻辑混乱。标准做法是先转成 url.Values（即 map[string][]string），修改后再调用 .Encode() 回填。
示例：
立即学习“go语言免费学习笔记（深入）”；
u, _ := url.Parse("https://example.com/path?name=go&id=123")
q := u.Query() // 类型是 url.Values
q.Set("id", "456") // 覆盖（只留一个值）
q.Add("tag", "backend") // 追加（允许同 key 多值）
q.Del("name") // 删除整个 key
u.RawQuery = q.Encode() // 必须重新 Encode，不能拼字符串
注意：Set 会清空同 key 的所有旧值，Add 不会；Encode() 自动做 URL 编码，别自己调 url.QueryEscape 再拼。
为什么 url.Values.Get 只返回第一个值？
url.Values 是 map[string][]string，但 .Get(key) 方法设计为“取首个值并解码”，适用于绝大多数单值场景（如表单提交）。如果你明确需要所有值，必须用 v[key] 索引，再手动遍历或判断长度。
-
q.Get("x")→"a"（当q["x"] = []string{"a", "b"}） -
q["x"]→[]string{"a", "b"}，可进一步处理 -
q.Get("missing")→ 空字符串""，不是 nil；要判空得用len(q["x"]) == 0
这点容易导致多选下拉框、复选框等场景漏数据——它们常以相同 key 多次出现，比如 ?role=admin&role=user。
修改参数时要注意哪些编码和兼容性坑？
URL 参数值含中文、空格、@、/ 等字符时，url.Values.Encode() 会自动编码，但原始 RawQuery 里的内容不会自动重编码。如果手动拼接 RawQuery 字符串，极易产生双重编码（如把已编码的 %E4%BD%A0 再 encode 成 %25E4%25BD%25A0）。
- 永远不要对已编码的字符串再调
url.QueryEscape - 从
u.RawQuery解析出来的值，url.ParseQuery已自动解码，修改后必须用.Encode()重新编码 - 不同 Go 版本对非法字符（如未编码的空格）容忍度不同：1.19+ 更严格，可能 panic；老版本静默修复，行为不一致
真正麻烦的是混合来源参数：比如从 header、body、path 中提取的片段，未经统一 decode 就塞进 url.Values，后续 Encode() 会出错或乱码。这类边界情况，务必在写入前统一 url.PathUnescape 或 url.QueryUnescape。
