Go PathEscape 和 QueryEscape 有什么区别

Go 里这两个函数不是“一个新版本、一个旧版本”的关系，而是服务于 URL 的不同位置：动态值要放进路径段时用 url.PathEscape，要放进查询参数值时用 url.QueryEscape。最容易出错的地方是 /、+ 和 &：它们在路径和查询中的语义并不相同。

先看输入放在 URL 哪个位置

先把完整 URL 拆成结构再选函数。/files/report/2026 中的 report 和 2026 是路径段；?name=report&page=2 中的 name 值是查询参数。PathEscape 的文档定义就是安全放入 URL path segment，包含斜杠在内的特殊字符会按需要转成 %XX；QueryEscape 则面向 URL query。

用边界字符做一次对照

不要只拿字母测试。下面的输入同时含有路径分隔符、加号和与号，正好能暴露两个函数的差异：

package main

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

func main() {
    raw := "a/b+c&d"

    // 路径段中的 / 是数据，不能让它继续制造新的层级。
    fmt.Println(url.PathEscape(raw))
    // 查询值中的 + 和 & 也必须与查询结构区分开。
    fmt.Println(url.QueryEscape(raw))
}

结果可以理解为两种语境的保护：路径版本会把 / 编成 %2F，而查询版本还会把 + 和 & 编成各自的百分号形式。于是，同一个字符串不能因为“看起来都是 URL”就随便选一个函数。

查询参数优先交给 url.Values

单独调用 QueryEscape 适合解释函数差异；业务代码拼多个参数时，更稳妥的写法是让 url.Values.Encode 负责键值和分隔符：

func searchURL(keyword string, page int) string {
    values := url.Values{}
    // Set 只接收参数值，& 和 = 由 Encode 统一处理。
    values.Set("q", keyword)
    values.Set("page", strconv.Itoa(page))

    return "https://example.com/search?" + values.Encode()
}

这个示例需要额外导入 strconv。如果只拼接一个值，url.QueryEscape(keyword) 也可以；但不要先对整段 q=...&page=... 做一次转义，否则查询结构会被一起编码，服务端就无法按参数拆分。

解码时也要保持同一语境

路径编码与查询编码要成对处理：路径用 PathUnescape，查询用 QueryUnescape。官方文档特别说明，PathUnescape 不会把加号变为空格，而查询解码遵循 query 的加号语义。若使用 url.Parse 后读取查询，优先调用 u.Query()，不要手动按 & 和 = 切字符串。

• 一个动态值只编码一次，不要把已经含有 %2F 的结果再次编码。
• 路径参数和查询参数分开处理，不能用同一个“万能转义函数”。
• 发现参数串位时，先查看 RawQuery 是否仍保留正确的键值分隔关系。

相关问题

PathEscape 会不会把斜杠编码掉？

会。它面向单个路径段，输入中的 / 会被编码为 %2F，这样斜杠作为数据而不是层级分隔符。

查询参数能不能直接用字符串拼接？

可以但容易漏掉边界，推荐用 url.Values。它把参数值编码和 &、= 分隔交给同一套逻辑。

为什么编码后看到加号不一定是空格？

因为加号在 query 和 path 中的语义不同。必须先确认数据所在位置，再选择对应的 Escape 与 Unescape 函数。

记忆方法很简单：路径段看 PathEscape，查询值看 QueryEscape，多个查询参数看 url.Values。把 URL 结构先分清，绝大多数“编码成功但请求含义变了”的问题就能在拼接前解决。