不能直接用url.QueryEscape处理完整URL，因为它只适用于查询参数值编码，会错误转义/、:、?等URL结构字符，破坏URL语法；正确做法是对参数键值单独编码后拼接，或使用url.URL结构体构建。
URL编码时为什么不能直接用 url.QueryEscape 处理完整 URL？
因为 url.QueryEscape 只对“查询参数值”做编码，它会把 /、:、? 等 URL 结构字符也转义掉，导致生成的 URL 无法被正确解析。比如对 "https://example.com/path?k=v with space" 直接调用，结果里连 / 都变成 %2F，浏览器或服务端根本认不出这是个合法 URL。
正确做法是：只对参数键和值单独编码，再拼进 URL：
u := &url.URL{
Scheme: "https",
Host: "example.com",
Path: "/search",
RawQuery: url.Values{"q": []string{<code>"golang 编码"</code>}}.Encode(),
}
或者手动拼接（更常见）：
q := url.QueryEscape(<code>"golang 编码"</code>) fullURL := "https://example.com/search?q=" + q
-
url.QueryEscape适用于单个参数值，不带+替代空格，用的是%20 - 如果要兼容老系统（要求空格用
+），得自己替换：strings.ReplaceAll(url.QueryEscape(s), "%20", "+") - 不要对已含
?或&的字符串整体调用QueryEscape，会双重编码
url.PathEscape 和 url.QueryEscape 的区别在哪？
两者编码规则不同，用途完全分离：
立即学习“go语言免费学习笔记（深入）”；
-
url.PathEscape专用于路径段（path segment），保留/、.、@等路径合法字符，只转义其余特殊字符。适合编码user/name这类路径中的变量部分 -
url.QueryEscape专用于查询参数（query value），把空格转成%20，且不保留任何分隔符——因为 query 中&、=是分隔符，不能出现在值里
错用后果明显：
// ❌ 错误：用 QueryEscape 编码路径
path := "/users/" + url.QueryEscape("a/b") // 得到 "/users/a%2Fb" —— 本意是子路径，结果变成文件名的一部分
// ✅ 正确：用 PathEscape
path := "/users/" + url.PathEscape("a/b") // 得到 "/users/a%2Fb"，但语义正确，服务器能按路径解析
解码失败时常见错误是 url.QueryUnescape 返回 invalid URL escape
这个错误几乎总是因为输入字符串被多次编码过，或者混入了非 URL 编码格式的百分号（比如用户手输 %xx 但 xx 不是合法十六进制）。
- 先检查是否重复解码：比如某字段已被框架自动解码过，你又调一次
url.QueryUnescape - 若不确定来源，加一层容错：
if s, err := url.QueryUnescape(input); err != nil { s = input } // 退回到原始字符串 -
url.PathUnescape比QueryUnescape更严格，它拒绝未编码的/出现在应被编码的上下文中；若你解的是路径片段，优先用PathUnescape - 注意：
QueryUnescape会把+当空格处理（历史遗留），而PathUnescape不会——所以不要拿PathUnescape去解 query string
中文域名或路径中使用 url.Userinfo、url.Host 要额外处理
Go 的 url.URL 结构体默认不支持 IDN（国际化域名），直接赋值中文 host 会导致 URL.String() 输出乱码或解析失败。
必须先用 idna.ToASCII 转成 Punycode：
import "golang.org/x/net/idna"
host, _ := idna.ToASCII(<code>"例子.中国"</code>)
u := &url.URL{Scheme: "https", Host: host, Path: "/"}
// u.String() → "https://xn--fsq.xn--fiqs8s/"
-
idna.ToASCII用于生成可传输的域名；idna.ToUnicode用于显示给用户（如日志、调试） -
url.Userinfo中的用户名/密码若含中文，也要分别用url.User(url.QueryEscape(user), pwd)构造，不能直接塞进去 - 路径中含中文时，仍用
url.PathEscape，它本身支持 UTF-8 字节序列，无需额外转换
IDN 处理容易漏掉，尤其在构建跳转链接或反向代理场景下，一不小心就返回 400 或 DNS 解析失败。
