根本原因是原始url的rawquery未合法编码，如?name=张三会导致url.parse()丢弃整个query，使query()返回空map；query()自动解码，但前提是rawquery格式正确（key=value、&分隔、值已编码）。
Query() 返回空或中文变成 %E4%B8%AD 是怎么回事
根本原因不是 Go 解析错了，而是原始 URL 的 RawQuery 本身就不合法 —— 比如手拼的 ?name=张三 或 ?q=hello world，空格、中文、&、= 等字符未经 url.QueryEscape 编码，url.Parse() 会直接丢弃整个 query 部分，导致 Query() 返回空 map。
真正起作用的是 Query() 方法：它内部调用 url.ParseQuery(u.RawQuery) 并自动解码值。但前提是 RawQuery 格式正确（key=value 形式、& 分隔、值已编码）。
- 合法示例：
https://a.com/?q=%E4%B8%AD%E6%96%87&tag=go→u.Query().Get("q")得到"中文" - 非法示例：
https://a.com/?q=中文→u.Query()返回空 map，u.RawQuery可能是空或只含部分参数 - 救急办法：若必须处理“脏 URL”，跳过
Query()，直接对u.RawQuery调用url.ParseQuery()，它容忍度更高，且返回map[string][]string
别用字符串拼接构造 query，用 url.Values.Encode()
写 urlStr := "https://api.com/search?q=" + keyword + "&sort=asc" 是高危操作 —— keyword 里只要出现空格、中文、&、=、/，生成的 URL 就非法，服务端收不到完整参数，甚至被截断或注入。
url.Values 是唯一安全的中转层，它内部强制调用 url.QueryEscape 对每个值编码，且自动处理重复 key、多值等边界情况。
- 单值覆盖用
v.Set("q", "Go语言") - 多值追加用
v.Add("tag", "backend")、v.Add("tag", "cli") - 最终必须用
v.Encode()得到 query 字符串，再赋给u.RawQuery - 切记：修改
u.RawQuery后，要调用u.String()才能得到完整合法 URL，不能直接拼接
路径 segment 和 query 参数编码不能混用 url.PathEscape / url.QueryEscape
路径中的特殊字符（如 /、?、#）和查询参数中的特殊字符（如 &、=、空格）编码规则不同，用错函数会导致解析失败或服务端 400。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
url.PathEscape 专用于路径段（path segment），它保留 / 不编码；url.QueryEscape 专用于 query 值，它把 / 编成 %2F，把空格编成 %20。
- 错误：用
url.QueryEscape("/api/v1")→%2Fapi%2Fv1，塞进u.Path会导致路径被当成字面量，找不到路由 - 正确：路径部分用
url.PathEscape("user/张三")→user%2F%E5%BC%A0%E4%B8%89，再拼进u.Path - 查询参数值一律用
url.QueryEscape，哪怕它是 URL 字符串（如url.QueryEscape("https://x.com/a?b=c")）
修改 URL 字段后必须调用 u.String() 才生效
url.URL 结构体字段（Scheme、Host、Path、RawQuery 等）只是数据容器，它们之间没有自动同步逻辑。改了 u.Path 不等于 URL 字符串变了，也不影响 u.String() 的输出结果 —— 直到你显式调用它。
常见误区是改完字段就直接打印 u 或传给 HTTP client，结果发出去的还是旧 URL。
- 修改任意字段后，最终输出或发送前，必须执行
finalURL := u.String() - 如果只改
RawQuery，别忘了它必须是url.Values.Encode()的结果，不是原始键值对字符串 - 注意
Fragment字段不参与网络传输，但会影响前端路由，修改后同样要走String()
最易被忽略的是：路径和 query 的编码责任完全在使用者手上，net/url 不会帮你补救“看起来差不多”的字符串 —— 它只认 RFC 3986 合规输入。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
