应使用url.values.encode()拼接多参数，而非手拼或对整个url调用url.queryescape；后者会错误转义:、/、?导致400错误；url.queryescape仅适用于单个query值（如搜索词），空格转+，中文转%e4%b8%ad，/等合法字符不转义。
直接用 url.Values + Encode()，别手拼字符串，也别对整个 URL 调 url.QueryEscape —— 后者会把 :、/、? 全部转义，请求直接 400。
url.QueryEscape 只能用于单个 query 值
它设计目标就是处理 ?key=value 中的 value 部分，比如用户输入的搜索词、API key、JSON 字符串等。它的行为严格遵循 application/x-www-form-urlencoded 规范：
- 空格 →
+（不是%20） - 中文、单引号、括号 →
%E4%B8%AD、%27、%28 -
/、:、@等在 query 值中合法的字符，默认不编码 —— 这不是 bug，是规范要求 - 错误用法：
url.QueryEscape("https://api.com?q=1")会把://和?都变成%3A%2F%2F、%3F，服务端收不到有效路径
多个参数必须用 url.Values.Encode()
手动拼 "?q=" + url.QueryEscape(q) + "&page=" + url.QueryEscape(p) 容易漏空值、错顺序、多加 &、忽略重复 key。标准库的 url.Values 自动处理所有边界情况：
-
v := url.Values{}创建映射 -
v.Set("q", "hello world")→ 键唯一，值自动编码 -
v.Add("tag", "go")→ 支持同名多值 -
v.Encode()返回完整 query 字符串，空格变+，中文变%E4%B8%AD，且保证=和&不被误编码
示例：v.Set("script", "g.V().has('name', '张三')") → script=g.V().has(%27name%27%2C+%27%E5%BC%A0%E4%B8%89%27)
路径段要用 url.PathEscape，不能和 QueryEscape 混用
URL 路径里的 / 是语义分隔符，比如 /users/张三/orders，其中 张三 是路径段，必须保留 / 的原始含义。这时：
-
url.PathEscape("张三")→%E5%BC%A0%E4%B8%89（空格变%20，不碰/） -
url.QueryEscape("a/b")→a%2Fb（/被编码为%2F，适合 query 值里含斜杠的场景） - 误用
url.QueryEscape编码路径段，会导致/users/%E5%BC%A0%E4%B8%89变成/users/%25E5%25BC%25A0%25E4%25B8%2589（如果服务端再解一次），路由完全失效
解码时别重复调用 url.QueryUnescape
Go 的 http.Request 在解析请求时已自动调用 url.QueryUnescape，所以 req.URL.Query().Get("q") 返回的就是解码后的字符串。常见陷阱：
- 收到
?q=hello%20world，直接req.URL.Query().Get("q")得到"hello world"；再手动url.QueryUnescape一次，可能把%2520（即已被编码过的%20）解成%20字面量，或触发invalid URL escape "%xx"错误 - 只有从非标准位置取值时才需手动解码：比如从
req.Header.Get("X-Callback-Url")或 POST body 里拿到的已编码字符串 -
url.QueryUnescape对输入极敏感：残缺的%AB、非法字符如%XZ、控制符都会返回 error，务必检查err
最易被忽略的一点：路径段解码必须用 url.PathUnescape，它允许 %2F，而 url.QueryUnescape 会拒绝它 —— 因为路径里的 %2F 是合法的，query 里的才是非法的。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
