Go net/url.URL EscapedPath 怎样保留原始路径编码

在 Go 里解析 https://example.com/x/y%2Fz 后，直接打印 URL.Path 往往会看到 /x/y/z。这不是原始 URL 被错误修改了，而是 net/url 把 Path 保存成了解码后的语义路径。需要保留原始路径编码时，应该调用 EscapedPath()，不要直接读取 RawPath。

下面只讨论路径字段：如何复现差异、三个字段如何分工，以及在签名、日志和请求路径拼接中怎样选择输出方法。

先看一个路径编码差异

准备一个最小示例。代码只观察 URL 字段，不访问网络：

package main

import (
    "fmt"
    "log"
    "net/url"
)

func main() {
    // %2F 表示被编码的斜杠，用来观察语义路径和原始路径的区别。
    u, err := url.Parse("https://example.com/x/y%2Fz")
    if err != nil {
        // 解析失败时立即结束，避免继续读取不完整的 URL。
        log.Fatal(err)
    }

    // Path 是解码后的语义路径，RawPath 只是可选的编码提示。
    fmt.Println("Path:", u.Path)
    fmt.Println("RawPath:", u.RawPath)
    // 需要稳定得到编码路径时，优先使用 EscapedPath。
    fmt.Println("EscapedPath:", u.EscapedPath())
    fmt.Println("String:", u.String())
}

这个示例的预期观察结果是：Path 为 /x/y/z，而 RawPath、EscapedPath 和 String 会保留 %2F 这一有效编码提示。重点不在于记住某一行输出，而在于知道 Path 与编码形式承担的是两种不同语义。

Path、RawPath 和 EscapedPath 到底有什么区别

Path 是程序通常使用的路径内容，解析后已经是解码形式；因此它适合做路径判断、路由匹配或业务层比较，但不适合用来还原输入时的转义写法。

RawPath 是可选的编码路径提示。它只有在确实是 Path 的有效转义形式时才有意义。官方文档也建议一般调用 EscapedPath，而不是把 RawPath 当作最终结果直接读取。

EscapedPath 是稳定的输出入口：如果 RawPath 有效，就返回它；否则忽略该提示，并根据 Path 计算出合法的转义路径。URL.String 和 URL.RequestURI 也会使用这套路径编码逻辑。

需要保留编码时怎么写才稳

如果你要生成请求目标、记录可复现的访问路径，或者把路径放进签名输入，直接使用 EscapedPath()：

func requestTarget(u *url.URL) string {
    // EscapedPath 保留有效的原始编码，并在提示无效时自动重新编码。
    path := u.EscapedPath()
    if path == "" {
        // 空路径按请求目标需要补成根路径，避免得到不明确的空字符串。
        path = "/"
    }
    if u.RawQuery != "" {
        // RawQuery 已经是编码后的查询部分，这里只负责拼接，不再次转义。
        return path + "?" + u.RawQuery
    }
    return path
}

这里有两个边界。第一，RawQuery 与路径是不同字段，不能用路径函数处理查询串。第二，若你的目标是完整 URL，优先使用 u.String()；若只需要请求目标，再组合 EscapedPath() 与已有的 RawQuery。

RawPath 无效时为什么仍然应该调用 EscapedPath

手动修改 Path、拼接路径，或从其他结构组装 URL 后，旧的 RawPath 可能不再匹配新的 Path。此时直接读 RawPath 会把过期提示当成事实，而 EscapedPath() 会先判断它是否仍是 Path 的有效转义。

例如，路径语义是 /docs/a/b，但 RawPath 却是一个无法对应它的编码字符串，EscapedPath 就会放弃该提示，重新产生能表达当前 Path 的编码结果。这种回退正是它比直接读 RawPath 更适合放在通用工具函数里的原因。

常见误区与速查

可以把判断压缩成一句话：Path 面向语义，EscapedPath 面向编码后的路径，RawPath 面向内部提示。只要代码需要输出 URL 或请求目标，就不要把 Path 直接拼回字符串。

相关问题

Path 和 RawPath 为什么有时一样，有时不一样？

没有特殊编码时，两者可能看起来一致；当输入包含 %XX 转义且该转义能对应 Path 时，RawPath 才可能保留这份原始写法。

EscapedPath 会永远返回输入时的字面形式吗？

不会。它优先使用有效的 RawPath；如果提示缺失或无效，就按 Path 重新计算一种合法的转义形式，所以它保证的是有效输出，不是无条件保存每个字面细节。

为什么不直接读取 RawPath？

因为 RawPath 可能为空，也可能已经和修改后的 Path 不匹配。把它当最终值会让调用方承担一致性判断，通用代码应调用 EscapedPath。