url.parse忽略fragment因rfc 3986规定其属客户端处理;需手动提取;url.parserequesturi遇fragment报错;values.get安全取值;ipv6主机须用方括号;三组escape函数用途各异。

URL.Parse 会忽略 fragment(# 后内容)
url.Parse 默认不解析 fragment 部分,即 #section1 这类锚点会被直接丢弃,URL.Fragment 字段为空。这不是 bug,而是符合 RFC 3986 —— fragment 属于客户端处理范畴,不参与网络请求。
若你确实需要保留 fragment(比如做前端路由反解、日志归一化),得手动从原始字符串中提取:
raw := "https://example.com/path?x=1#section1" u, _ := url.Parse(raw[:strings.LastIndex(raw, "#")]) // 先切掉 fragment fragment := raw[strings.LastIndex(raw, "#")+1:] // 单独取
注意:url.ParseRequestURI 更严格,遇到带 fragment 的完整 URI 会直接返回错误,因为它只接受可用于 HTTP 请求的合法 URI。
Query 参数解析:Values.Get 和 Values["key"] 行为不同
url.Values 是 map[string][]string,但直接用 values["key"] 可能返回空 slice(而非 nil),而 values.Get("key") 才是安全取值方式 —— 它自动返回第一个值或空字符串。
立即学习“go语言免费学习笔记(深入)”;
-
values["missing"]→[]string{}(空 slice,len=0,但非 nil) -
values.Get("missing")→"" -
values.Get("k")对k=["a","b"]→ 返回"a"(不是拼接)
常见误用:用 if values["k"] != nil 判空,结果永远为 true;正确写法是 if len(values["k"]) > 0 或直接用 Get。
Host 解析要注意 port 和 IPv6 地址格式
URL.Host 字段返回的是 “host:port” 形式,即使没显式指定 port,url.Parse 也会根据 URL.Scheme 补上默认端口(如 http→":80"),但仅当 URL.Opaque 为空时才生效。
IPv6 地址必须用方括号包裹,否则 Parse 会把冒号误判为 port 分隔符:
- ✅ 正确:
url.Parse("http://[2001:db8::1]:8080/") - ❌ 错误:
url.Parse("http://2001:db8::1:8080/")→ 解析出 Host="2001:db8::1:8080",无 port,且 Scheme 也被破坏
判断是否为 IPv6 主机?别靠字符串匹配 ":",用 net.ParseIP(u.Hostname()).To4() == nil 更可靠。
Escape 和 Unescape 容易混淆的三组函数
标准库提供三套编码/解码函数,用途完全不同,混用会导致乱码或安全漏洞:
-
url.PathEscape(s)/url.PathUnescape(s):专用于 path 段,不编码/和@等路径分隔符 -
url.QueryEscape(s)/url.QueryUnescape(s):用于 query 值,把空格转成+,且编码更激进(包括/) -
url.UserPassword中的密码需用url.User(url.QueryEscape(pass)),否则特殊字符会破坏 basic auth 结构
典型错误:用 QueryEscape 处理 path 路径,导致 / 变成 %2F,服务端收不到预期的多级路径。









