Go语言解析URL教程详解

Go解析URL必须用url.Parse()而非字符串切分，路径和查询参数需分别用url.PathEscape()和url.QueryEscape()编码，修改后须调u.String()生成合法URL。

Go 解析 URL 不能靠字符串切分，必须用 url.Parse() 得到结构体，否则路径、查询参数里的中文、空格、斜杠全会出错。

解析 URL 时 query 为空或乱码？检查原始编码是否合法

常见错误现象：url.Parse() 后 u.RawQuery 看着正常（比如 "q=中文&tag=go"），但 u.Query().Get("q") 返回空字符串，或值是 "%E4%B8%AD%E6%96%87" 没解出来。

• 根本原因：URL 查询参数必须符合“application/x-www-form-urlencoded”编码规范；手拼 ?q=张三 是非法的，url.Parse() 会直接丢弃整个 query
• 正确做法：前端传来的“脏” URL（未编码）应先用 url.ParseQuery(u.RawQuery) ——它比 u.Query() 更宽容，能处理部分编码不全的情况
• u.Query() 是“严格模式”：只在确认原始 query 已合法编码时才用，它内部调用 url.ParseQuery 并自动解码 UTF-8
• 无效 UTF-8 字节会被替换成 \ufffd，且不报错，容易埋坑

从 HTTP 请求里取参数，别碰 r.FormValue 除非你真要 fallback

使用场景：写 http.HandlerFunc 时提取 ?id=123&format=json 这类参数。

• 推荐直接用 r.URL.Query() —— 它线程安全、已解码、可复用，底层就是 url.ParseQuery(r.URL.RawQuery)
• r.FormValue("key") 会先调用 r.ParseForm()，再查 r.Form；它会合并 POST body 和 query 参数，行为更重，也更模糊
• 如果请求没 query 只有 body，r.FormValue 才有意义；纯 GET 查询参数，r.URL.Query() 更精准、无副作用
• 注意：r.URL.Query() 返回的是 url.Values（即 map[string][]string），同名参数如 ?tag=a&tag=b 会保留为切片

构建带中文/特殊字符的 URL，绝不能字符串拼接

错误示例："https://api.com/search?q=" + keyword —— 只要 keyword 含空格、&、= 或中文，服务端就收不到完整值。

• 路径段（如 /user/张三）必须用 url.PathEscape()，它不编码 /，只处理语义字符
• 查询值（如 q=Go语言）必须进 url.Values，用 .Set() 或 .Add()，再调 .Encode() 生成 RawQuery
• 不要手动改 u.RawQuery = "q=" + url.QueryEscape(s) —— 多参数时容易漏 &、顺序错、编码重复
• url.QueryEscape() 把空格转成 +，url.PathEscape() 把空格转成 %20，二者不可互换

修改 URL 字段后，记得调 u.String()

常见错误：改了 u.Path 或 u.RawQuery，直接打印 u 或返回结构体，结果还是旧 URL。

• url.URL 是个结构体，字段修改不会自动同步到最终字符串表示
• 所有修改（包括设置 u.User、u.Fragment）完成后，必须显式调用 u.String() 才能得到合法 URL 字符串
• 别自己拼 u.Scheme + "://" + u.Host + u.Path + "?" + u.RawQuery —— 会漏转义、错端口、丢用户信息，u.String() 才是唯一可靠出口
• 路径拼接要用 path.Join()（来自 path 包），不是字符串 +，避免双斜杠或丢失末尾 /

最常被忽略的一点：路径和 query 的编码规则完全不同，url.PathEscape 和 url.QueryEscape 不能混用，连解码函数都要配对 —— 用错一个，路由 404 或参数收不到，问题还很难复现。