Go 的 net/url 包需谨慎使用：缺失 scheme 时应补全再解析；Query 参数用 u.Query() 解码获取键值，u.RawQuery 保留原始编码；路径拼接须用 u.EscapedPath()；IPv6 下应通过 u.Hostname() 和 u.Port() 安全提取主机与端口。
Go 的 net/url 包能可靠解析标准 URL，但直接调用 url.Parse() 并不能解决所有常见需求——比如带中文路径、不规范的查询参数、或缺失 scheme 的字符串，都容易返回错误或产生意外结果。
url.Parse() 会因 scheme 缺失而失败
很多实际场景中，用户输入的是形如 example.com/path?k=v 或 //cdn.example.com/assets.js 这类无 scheme 的 URL 字符串。此时 url.Parse() 会返回 nil 和错误 parse "example.com/path": missing protocol scheme。
解决方法是先补全 scheme（如 https://），再解析；或者用 url.ParseRequestURI() 区分用途：
-
url.Parse()：适用于已知完整 URL（含 scheme）且允许相对路径的场景（如重定向跳转逻辑） -
url.ParseRequestURI()：严格要求绝对 URI，拒绝相对路径，更适合校验用户输入的“完整地址”
若必须处理无 scheme 输入，建议手动前置判断并补全：
立即学习“go语言免费学习笔记（深入）”；
u, err := url.Parse("example.com/path?a=1")
if err != nil {
u, err = url.Parse("https://" + "example.com/path?a=1")
}
Query 参数解析要调用 RawQuery 或 Query() 方法
url.Parse() 返回的 *url.URL 结构体中，RawQuery 是原始未解码的查询字符串（如 a=%E4%BD%A0%E5%A5%BD&b=2），而 Query() 方法才返回自动解码并解析为 url.Values（即 map[string][]string）的结果。
常见误区是直接读取 u.RawQuery 然后自己用 url.ParseQuery() 解析——这会导致重复解码或编码错误。
正确做法：
- 想获取键值对映射 → 用
u.Query() - 想保留原始编码（如用于签名、透传）→ 用
u.RawQuery - 想修改参数后重建 URL → 修改
u.Query()返回值，再调用u.RawQuery = u.Query().Encode()
示例：
u, _ := url.Parse("https://a.b/c?name=%E4%BD%A0&age=25")
vals := u.Query() // map[name:[你] age:[25]]
vals.Set("age", "26")
u.RawQuery = vals.Encode()
// u.String() → "https://a.b/c?age=26&name=%E4%BD%A0"
中文路径和特殊字符需注意 EscapedPath() 与 Path 字段区别
*url.URL 的 Path 字段是**已解码**后的路径（如 /你好），而 EscapedPath() 方法返回的是**URL 编码后可用于拼接的路径字符串**（如 /%E4%BD%A0%E5%A5%BD）。直接拼接 u.Path 到新 URL 中，会导致中文乱码或 400 错误。
典型错误场景：构造 redirect 地址时写成 "https://new.com" + u.Path —— 这会把未编码的中文塞进 URL。
安全做法：
- 拼接 URL 时，始终使用
u.EscapedPath()或url.PathEscape()处理路径片段 - 从
u.Path读取语义化路径（如日志、路由匹配） - 注意
u.Path开头恒为/，即使原始 URL 是http://x/y，它也是/y
Host 和 Hostname() / Port() 的分离逻辑易被忽略
u.Host 是完整的 host:port 字符串（如 example.com:8080），但 u.Hostname() 和 u.Port() 才是拆解后的安全访问方式。直接对 u.Host 做字符串切分（如 strings.Split(u.Host, ":")）在 IPv6 地址下会出错（如 [::1]:8080）。
IPv6 支持是这里的关键差异点：
-
u.Hostname()正确剥离 IPv6 方括号和 port（返回::1） -
u.Port()在有端口时返回数字字符串，无端口时返回空字符串 -
u.Host永远保持原始格式，不应直接用于网络拨号或 DNS 查询
例如，做代理转发时应这样提取目标地址：
host := u.Hostname()
port := u.Port()
if port == "" {
port = "80"
if u.Scheme == "https" {
port = "443"
}
}
target := net.JoinHostPort(host, port)
真正麻烦的不是解析本身，而是不同字段的编码状态、IPv6 格式兼容性、以及 scheme 缺失时的兜底策略——这些细节一旦漏掉，线上就容易出现 400、乱码或连接失败。
