Go url.JoinPath 为什么会保留路径中的百分号编码

Go url.JoinPath 保留路径中的百分号编码，是因为参数约定本来就是已经转义的路径元素。它负责拼接和清理路径，不负责把最终地址变成人类阅读用的解码文本。要把原始业务名称作为一个路径段传入，应先调用 url.PathEscape；输入已经是合法的转义形式时，就不要再转义一次。

官方文档地址：https://pkg.go.dev/net/url

多个调用方共用拼接函数时，先统一输入含义

以多个模块共同生成对象地址为例：一个模块传入原始名称 manual/part 1.txt，另一个模块传入 manual%2Fpart%201.txt。如果公共函数不知道两者的含义，就容易在不同调用点重复转义，或先解码再拼接，把名称里的斜杠变成目录层级。

这种方案的瓶颈是接口语义不统一。建议公共入口只收原始业务字段，并在拼接位置统一转义；确有必要接收已转义路径时，应设置另一个明确命名的入口。这里讨论的是代码组织取舍，不是一次线上改造或性能测试报告。

把百分号编码与 URL 字段分开观察

URL.Path 表示解码后的路径；可选的 URL.RawPath 是编码提示，并非每次都有值。需要取得用于地址表示的路径，应调用 URL.EscapedPath()，而不是直接依赖 RawPath。URL.String() 会使用转义路径构造地址。

例如，地址路径里出现 %2F 时，Path 中可以看到普通斜杠，但这不意味着最终字符串一定把该斜杠当作分隔符。有效的编码提示可保留两者的差异。反过来，也不能把“保留百分号编码”理解为所有输入字节都原样不动：路径清理仍会发生。

在公共函数里只接收未转义的路径段

以下完整示例把名称作为单一路径段，统一由公共函数进行一次转义。example.com 是示例域名，不代表需要访问的实际服务。

package main

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

func objectURL(base, name string) (string, error) {
    // name 是一个原始业务名称；其中的斜杠属于数据，不是目录分隔符。
    return url.JoinPath(base, url.PathEscape(name))
}

func main() {
    address, err := objectURL("https://example.com/objects", "manual/part 1.txt")
    if err != nil {
        // 基础地址解析或拼接失败时停止，不把空地址交给调用方。
        log.Fatal(err)
    }
    parsed, err := url.Parse(address)
    if err != nil {
        log.Fatal(err)
    }
    // 同时观察语义路径与转义形式，避免只看 Path 就误判斜杠丢失。
    fmt.Printf("Path=%q\nEscapedPath=%q\nURL=%q\n",
        parsed.Path, parsed.EscapedPath(), address)
}

按这些 API 的语义，示例地址应为 https://example.com/objects/manual%2Fpart%201.txt；解码后的 Path 则是 /objects/manual/part 1.txt。这些是代码的预期字符串关系，不是本机执行记录。

公共函数的代价是调用方必须遵守“原始名称”契约。若调用方实际交来 manual%2Fpart%201.txt，函数会把其中的百分号视为名称字符，再编码成 %25。这在原始名称契约下是正确的，问题在于调用方交错了表示形式。

斜杠、点段与二次转义怎样取舍

不要为了消除地址里的百分号，先对整个路径执行 PathUnescape 再交给拼接函数。那会使编码斜杠与层级分隔符混在一起。需要展示友好文本时，在展示层单独解码副本；用于继续构造地址的数据仍保持既定表示形式。

另一个容易忽略的细节是 PathEscape(".") 和 PathEscape("..") 不会把点变成其他字符，而 JoinPath 会清理普通点段。若业务允许名称恰好为这些值，需要先决定拒绝、映射或使用其他标识形式，不能仅凭调用了 PathEscape 就认定名称一定无损。

接入后应观察哪些字符串差异

接入公共构造函数后，可以在开发环境用固定样例比较原始名称、EscapedPath() 与最终地址的差异，重点覆盖空格、名称内斜杠、字面百分号和普通点段。不要只检查字符串里是否出现百分号；应检查它是否表达预定的名称与层级。这里没有提供吞吐量或线上收益数据。

看到 %252F 就一定编码错了吗？

不一定。原始名称若包含字面文本 %2F，百分号本来就需要编码；只有调用方本来想表达已编码的斜杠，却又套了一次 PathEscape，才是两层契约混用。

为什么 RawPath 为空，地址仍然有 %20？

RawPath 只是可选提示。没有需要保留的特殊编码形式时，EscapedPath 可根据 Path 生成转义表示，空 RawPath 不等于不转义。

能用 QueryEscape 处理名称吗？

路径段使用 PathEscape。查询参数采用另一套编码规则，不能因为函数名里都有 Escape 就互换。

参考：Go net/url API 文档、Go net/url 官方实现。