Go 的 net/url 是结构化 URL 操作机制，非字符串工具：须带 scheme 解析、路径用 PathEscape、查询参数用 QueryEscape 并通过 url.Values 构建、修改字段后必须调 String() 才生效。
Go 的 net/url 不是字符串工具包，它是一套结构化 URL 操作机制——直接拼接、误用 QueryEscape 编码路径、改了字段不调 String()，都会导致请求 400、参数丢失或路由 404。
url.Parse 解析失败却不报错？先看有没有 scheme
Go 的 url.Parse 对格式极其敏感：缺 http:// 或 https://，它会把整个输入当路径处理。url.Parse("example.com/path?k=v") 返回的 *url.URL 中 Host 是空字符串，RawQuery 也是空——查询参数根本没被识别。
- 必须带 scheme：
url.Parse("https://example.com/path?k=v") - 用户输入可能是纯域名+路径（如搜索框），得手动补前缀：
"https://" + input再解析 - 别用
url.ParseRequestURI，它只接受绝对 URI，不支持相对路径或无 scheme 输入 -
url.Parse不校验域名合法性，url.Parse("http:///path")也能过，但Host == ""，后续逻辑全失效
Query() 返回空或中文还是 %E4%B8%AD？检查原始 query 是否合法编码
常见现象：u, _ := url.Parse("https://a.com/?q=张三") 后，u.Query().Get("q") 是空字符串，或 u.RawQuery 看着正常但 Query() 解不出中文。根本原因是：URL 解析器要求原始 query 部分本身就得是合法编码的；手写 ?q=张三 属于非法 URL，Go 直接丢弃整个 query。
- 构造 URL 时，值必须先过
url.QueryEscape："?q=" + url.QueryEscape("张三") - 若必须处理“脏”输入（如前端传来的未编码参数），用
url.ParseQuery(u.RawQuery)替代u.Query()，它容忍度更高，返回map[string][]string -
u.Query()每次调用都重新解析RawQuery，高频读取大 query 有轻微开销 - 修改查询参数后，必须显式赋回：
q := u.Query(); q.Set("t", "123"); u.RawQuery = q.Encode()
中文出现在路径里 404？别用 QueryEscape 编码 path
误把 url.QueryEscape("user/张三") 塞进 Path，得到 user%2F%E5%BC%A0%E4%B8%89，其中 %2F 被服务器当成了路径分隔符，路由匹配直接失败。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 路径段（如
/user/张三中的张三）必须用url.PathEscape："/user/" + url.PathEscape("张三") -
url.QueryEscape只用于 query value（?q=xxx中的xxx），它把空格变+，且不编码/；url.PathEscape把空格变%20，且严格保留/语义 - 不要对整个路径字符串调用任一 escape 函数——它们只设计用于单个字段
- API 路径含多段中文（如
/api/v1/user/张三/order/订单1），每段单独PathEscape，再拼接
构建完整 URL 时 RawQuery 改了却不生效？记得调 u.String()
url.URL 是值类型，改 u.RawQuery 或 u.Path 只是改字段快照，不会自动合成新字符串。打印 u 或直接用 fmt.Sprintf("%v", u) 看到的是结构体字段，不是最终 URL。
- 所有字段修改后，必须显式调用
u.String()才能得到合法 URL 字符串 - 推荐组合方式：
url.Values构建 query →v.Encode()赋给u.RawQuery→u.String()输出 - 手动拼
RawQuery（如"a=1&b=2"）风险高：易漏编码、错顺序、重复 key 处理不当；url.Values自动处理键值对分隔、空值跳过、同名多值等细节 -
v.Encode()输出符合application/x-www-form-urlencoded规范：空格变+，中文变%E4%B8%AD，不生成%20
最常被忽略的点是：url.PathEscape 和 url.QueryEscape 的语义边界非常硬——路径里混 query 编码，query 里混路径编码，服务端几乎必然出错；而改完 url.URL 字段不调 String()，得到的永远是旧值或结构体快照，不是可发出去的 URL。
