解析URL查询参数应使用url.ParseQuery而非url.Parse，因后者仅拆分结构、不解析键值对；url.ParseQuery自动解码、支持重复键，且需手动校验错误，r.URL.Query()不检查解析失败。
解析 URL 查询参数要用 url.ParseQuery，不是 url.Parse
很多初学者误以为 url.Parse 会自动解析查询参数为键值对，其实它只做 URL 结构拆分，RawQuery 字段仍是原始字符串（如 "name=alice&age=30"）。真正把查询字符串转成 map[String][]string 的是 url.ParseQuery。
常见错误现象：直接读 u.Query() 返回空字符串，或用 strings.Split 手动切分，结果无法正确处理重复键、编码字符（如空格变 + 或 %20）。
-
url.ParseQuery自动解码 URL 编码，支持重复 key（如?tag=a&tag=b→["a","b"]） - 若需单值优先（忽略重复），可用
values.Get("key")，它返回第一个值 - 若原始 URL 不合法（如未闭合的
%），url.ParseQuery会静默跳过非法片段，不报错
在 http handler 中安全获取查询参数要先校验 err
从 *http.Request 拿参数时，r.URL.Query() 是封装好的快捷方式，底层调用的就是 url.ParseQuery(r.URL.RawQuery)。但它不检查解析错误 —— 即使 RawQuery 是空或损坏，也返回空 url.Values，容易掩盖问题。
更稳妥的做法是手动解析并检查错误：
立即学习“go语言免费学习笔记（深入）”；
query, err := url.ParseQuery(r.URL.RawQuery) if err != nil { http.Error(rw, "invalid query", http.StatusbadRequest) return } name := query.Get("name") // 自动取第一个，空字符串表示不存在- 不要依赖
r.URL.Query()做关键业务判断，它对格式错误零容忍也不提示 -
query.Get和query["key"]行为不同：前者返回""（没 key 或值为空），后者返回[]string{}（空切片） - 如果参数必须存在且非空，建议显式检查：
if name == "" { ... }，而不是只判len(query["name"]) == 0
url.Values 编码后自动处理空格和特殊字符
构造查询字符串时，别用 fmt.Sprintf 或字符串拼接。手动拼接无法处理中文、空格、&、= 等，极易被注入或解析失败。
正确做法是用 url.Values 的 Encode() 方法：
v := url.Values{} v.Set("q", "hello world") v.Set("filter", "type=pdf&size=10mb") encoded := v.Encode() // 得到 "q=hello+world&filter=type%3Dpdf%26size%3D10mb"-
Encode()把空格转为+（符合 application/x-www-form-urlencoded 规范），不是%20 - 它会对
&、=等做双重编码，确保服务端ParseQuery能准确还原 - 如果需要生成带 fragment 的完整 URL，记得把
Encode()结果拼到?...后，再加#...，不要让Encode()处理 fragment
GET 和 POST 表单共用参数时注意 ParseForm 的副作用
当 handler 同时处理 GET 和 POST 请求，并想统一读取表单数据（包括 URL 查询参数和请求体），会调用 r.ParseForm()。这个操作有隐藏行为：
- 它会把
GET查询参数和POST表单字段合并进r.Form，同名 key 的值会追加（GET 值在前，POST 值在后） - 但
r.URL.Query()仍只含原始查询参数，不会受ParseForm影响 - 如果只调用了
r.ParseForm()却没读r.PostForm，而后续又调用r.FormValue("key")，它返回的是合并后的第一个值 —— 可能来自 URL，也可能来自 body，容易混淆来源
建议明确区分场景：纯 GET 就用 r.URL.Query()；需要混合读取时，先调 r.ParseForm()，再通过 r.Form（合并）、r.PostForm（仅 body）、r.URL.Query()（仅 URL）分别取值，避免假设。