url.Values 是 Go 标准库中用于安全构建 URL 查询参数的类型，本质为 map[string][]string，自带 Encode() 方法自动进行 UTF-8 百分号编码；需避免手动拼接或重复编码。
url.Values 是什么，为什么不能直接拼字符串
Go 里构建带参数的 URL，最常见错误是手动拼接 ?key=value&key2=value2 —— 这会漏掉 URL 编码，遇到空格、中文、斜杠等直接炸成无效链接。比如 "name=张三&tag=go/1.21" 不编码，浏览器收到的是 name=%E5%BC%A0%E4%B8%89&tag=go%2F1.21 才对。url.Values 就是标准库专门干这事的类型，本质是 map[string][]string，自带 Encode() 方法做安全编码。
用 url.Values.Add 和 url.Values.Set 的区别
两者都往 url.Values 写键值，但行为不同：Add 允许同一个 key 多次出现（比如多个 id=1&id=2），Set 则覆盖已有值。多数场景用 Set 更安全，除非你明确需要重复参数（如多选 filter）。
示例：
params := url.Values{}
params.Set("page", "1")
params.Set("q", "go module") // 自动编码空格为 %20
params.Add("sort", "asc")
params.Add("sort", "desc") // 最终生成 sort=asc&sort=desc
fullURL := "https://api.example.com/list?" + params.Encode()
构造完整 URL 时别漏掉 url.Parse 和 url.URL 结构体
只靠 url.Values.Encode() 拼接容易出错：如果原始 URL 已有 query，直接加 ? 会重复；如果路径含特殊字符（如 /user/张三），路径本身也要编码。正确做法是先 url.Parse 原始地址，再把 url.Values 赋给其 RawQuery 字段。
立即学习“go语言免费学习笔记（深入）”；
-
url.Parse("https://a.com/path?old=1")返回*url.URL - 修改
u.Query().Set("new", "2")后调用u.String()，自动合并旧 query - 若需清空原有 query，直接赋值
u.RawQuery = params.Encode()
中文、emoji、JSON 字符串传参时的典型坑
url.Values 对 value 调用 Encode() 时，会按 UTF-8 编码再百分号编码，这没问题；但如果你提前手动 url.PathEscape 或 url.QueryEscape，再塞进 url.Values，就会双重编码——比如 张三 变成 %25E5%25BC%25A0%25E4%25B8%2589（% 被当成字面量又编了一次）。
记住唯一原则：所有参数统一走 url.Values.Set 或 Add，最后调一次 .Encode()，中间不自己调任何 escape 函数。
