URL解析时query丢失或乱码，因Query()自动解码但要求原始query合法编码；应使用url.Values.Encode()构造query，路径段用url.PathEscape而非QueryEscape，修改URL字段后须调用u.String()生成最终URL。
解析 URL 时 query 参数丢失或乱码
常见现象是 url.Parse 后 RawQuery 看着正常，但 Query() 返回空或字段值全是空字符串，或者中文变成 %E4%B8%AD 这种编码没解出来。
根本原因是：URL 解析本身不自动解码 query 值；Query() 返回的是已解码后的 map，但如果原始 URL 的 query 部分本身没经过合法编码（比如手拼的 ?name=张三），Go 会直接解析失败，丢弃整个 query。
- 确保原始 URL 的 query 部分是合法编码的——用
url.QueryEscape处理值再拼接，别手写 - 如果必须处理“脏” URL（比如前端传来的未编码参数），先用
url.Parse得到结构体，再手动对RawQuery做url.ParseQuery，它容忍度更高 -
url.ParseQuery返回的是map[string][]string，注意同名参数会以切片形式存在，不是单个字符串
示例：
u, _ := url.Parse("https://example.com/?q=%E4%B8%AD%E6%96%87&tag=go")
vals := u.Query() // 自动解码，vals.Get("q") == "中文"
构建带中文/特殊字符的查询参数
直接字符串拼接 "?name=" + name 是最常踩的坑——只要 name 含空格、&、=、中文等，URL 就非法，服务端收不到或解析错。
必须用 url.Values 中转，它内部调用 url.QueryEscape 做安全编码：
立即学习“go语言免费学习笔记（深入）”；
- 用
url.Values.Set或.Add添加参数，不要自己拼RawQuery - 多个同名参数用
Add，单值覆盖用Set - 构造完用
Encode()得到合法 query 字符串，再塞进 URL
示例：
v := url.Values{}
v.Set("q", "Go语言教程")
v.Add("tag", "backend")
v.Add("tag", "golang")
u := &url.URL{
Scheme: "https",
Host: "api.example.com",
Path: "/search",
RawQuery: v.Encode(), // 得到 q=Go%E8%AF%AD%E8%A8%80%E6%95%99%E7%A8%8B&tag=backend&tag=golang
}
路径部分的编码和解码不能用 QueryEscape
很多人误以为 url.QueryEscape 能处理路径里的中文或斜杠，结果把 /user/张三 编成 %2Fuser%2F%E5%BC%A0%E4%B8%89，导致路由匹配失败——因为 %2F 是编码后的 /，被当成了路径分隔符。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
路径段（path segment）要单独编码，用 url.PathEscape，它不会编码 /，只处理其他特殊字符：
-
url.PathEscape("张三")→%E5%BC%A0%E4%B8%89，安全用于路径 -
url.PathEscape("/user/张三")→ 错！应拆成"/user/" + url.PathEscape("张三") - 解码路径用
url.PathUnescape，不是QueryUnescape
错误示范：url.QueryEscape("/user/张三") 会把斜杠也编码，破坏路径结构。
URL 结构修改后忘记重新生成 String()
很多人改了 *url.URL 的 Path、RawQuery 或 Fragment 字段，然后直接打印 struct 或传给 HTTP 客户端，发现请求发到了旧地址。
Go 的 url.URL 是不可变语义的：字段修改不会自动更新 String() 输出，必须显式调用方法获取最终 URL 字符串：
- 修改字段后，用
u.String()拿完整 URL（自动按规范拼接） - 不要直接
fmt.Sprintf("%s://%s%s", u.Scheme, u.Host, u.Path)—— 会漏掉 query、fragment、端口、用户信息等 - 若需裸路径（不含 scheme/host），用
u.RequestURI()，它返回相对路径+query+fragment，适合 HTTP 请求行
容易忽略的一点：u.String() 对 Path 和 RawQuery 的内容不做二次编码，所以你填进去的必须已经是合法编码后的值。
