url.QueryEscape不能直接处理完整URL，因为它专为转义查询参数的键或值设计，会错误转义冒号、斜杠、问号等URL结构字符；正确做法是用url.URL配合url.Values，由params.Encode()自动安全编码各参数并拼装。
为什么 url.QueryEscape 不能直接处理完整 URL？
很多人试图用 url.QueryEscape 对整个 URL 字符串（比如 "https://example.com/path?name=张三&city=北京"）编码，结果发现斜杠、冒号、问号全被转义了——这显然不是你想要的。因为 url.QueryEscape 的设计目标只有一个：安全编码「查询参数值」，它把所有非 ALPHA / DIGIT / - _ . ~ 的字符都百分号编码，连 / 和 ? 都不放过。
正确做法是只对 query 参数的 键和值 分别编码，再拼进 URL。Go 标准库提供了更稳妥的路径：url.URL 结构体 + url.Values。
- 永远不要对整个 URL 调用
url.QueryEscape - 若原始 URL 已含 query（带
?），先用url.Parse解析，再修改RawQuery或Query() - 手动拼接时，务必对每个 value 单独调用
url.QueryEscape，key 通常也建议编码（虽然规范允许部分字符不编码）
用 url.Values 构建并编码 query 字符串
url.Values 是 map[string][]string 的别名，它内置了 Encode() 方法，会自动对 key 和 value 做 QueryEscape，并按 key=value&key2=value2 格式组装。这是最常用、最不易出错的方式。
u := &url.URL{
Scheme: "https",
Host: "api.example.com",
Path: "/v1/search",
}
params := url.Values{}
params.Set("q", "Go语言教程") // 自动编码为 q=Go%e8%af%ad%e8%a8%80%e6%95%99%e7%a8%8b
params.Set("page", "1")
u.RawQuery = params.Encode() // 得到 "q=Go%e8%af%ad%e8%a8%80%e6%95%99%e7%a8%8b&page=1"
<p>fmt.Println(u.String()) // <a href="https://www.php.cn/link/15bc103c20a326afd1c21299dc720d4e">https://www.php.cn/link/15bc103c20a326afd1c21299dc720d4e</a>立即学习“go语言免费学习笔记（深入）”；
-
params.Add()用于追加同名 key（如多选 checkbox），Set()会覆盖已有值 -
Encode()内部调用的是QueryEscape，所以中文、空格、&、+ 等都会被正确处理 - 注意：
Encode()返回的是纯 query 字符串（不含?），需赋给u.RawQuery，不是u.Path
解码 query 时，优先用 url.ParseQuery 而非 url.QueryUnescape
如果你拿到的是完整 URL 字符串，想提取 query 参数，别手动切分 ? 后面的部分再用 url.QueryUnescape——这样要自己处理 & 拆分、= 解析、重复 key 等逻辑，极易出错。
url.ParseQuery 接收 raw query 字符串（如 "name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC"），返回 url.Values，已自动解码且支持多值：
rawQuery := "name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC&tag=go&tag=golang"
values, err := url.ParseQuery(rawQuery)
if err != nil {
log.Fatal(err)
}
fmt.Println(values.Get("name")) // 张三（自动解码）
fmt.Println(values["tag"]) // ["go" "golang"]（保留多值）
-
url.ParseQuery只处理 query 部分，不解析 scheme/host；若你有完整 URL，请先用url.Parse，再取u.RawQuery传入 -
url.QueryUnescape仅适合单个已编码字符串的“反向转换”，比如解码一个单独的文件名或搜索词，别拿它去解析整段 query - 注意：
ParseQuery会把+当作空格解码（符合 HTML 表单惯例），这点和QueryUnescape一致
特殊场景：需要保留原始编码或处理非标准分隔符
极少数接口要求 query 中某些字符不被编码（比如 . 或 ~），或者使用 ; 代替 & 分隔参数（RFC 3986 允许但极少用）。这时不能依赖 url.Values.Encode()，得手动控制。
- 若需跳过特定字符编码，可先用
url.QueryEscape，再用strings.ReplaceAll还原（不推荐，易破坏语义） - 更稳妥的做法是实现自定义编码函数，只对真正危险的字符（如
<,>,",#,{,}）做处理，其余放行 - 遇到
;分隔的 query（如path;param=value），Go 的url包不支持解析，需用正则或strings.Split手动拆分，再逐个url.QueryUnescape
大多数真实项目里，老老实实用 url.Values 就够了；硬要绕开它，往往是因为没理清「URL 结构」和「query 语义」的区别——这才是最容易被忽略的底层逻辑。
