Go QueryUnescape 遇到加号为什么变成空格

在 Go 里调用 url.QueryUnescape("a+b") 得到 a b，通常不是字符串被破坏，而是输入被当成了查询编码。application/x-www-form-urlencoded 约定用加号表示空格；如果加号本身是业务数据，就必须先以 %2B 传输，或者根据数据所在位置改用路径解码函数。

结论很简单：查询参数用 QueryUnescape 时，+ 表示空格；想保留真实加号，应传 %2B。URL 路径里的加号不是查询空格，应使用 PathUnescape 或先确认上游的编码边界。

为什么 QueryUnescape 会把 + 变成空格

QueryUnescape 是 QueryEscape 的逆操作。查询参数常见于表单提交和 URL 的 ?key=value 部分，在这类编码里，空格可以写成加号。因此解码器看到 + 时，会按查询规则还原成空格；它并不知道这个加号原本是不是某个业务字段里的数学符号。

下面的例子把三种输入放在一起比较。注意第二个输入使用 %2B，这是“解码后必须得到真实加号”的明确表达。

package main

import (
    "fmt"
    "net/url"
)

func main() {
    samples := []string{"go+url", "go%2Burl", "go%20url"}
    for _, raw := range samples {
        decoded, err := url.QueryUnescape(raw)
        if err != nil {
            // 百分号编码不完整时，保留错误而不是继续使用半成品。
            fmt.Printf("%q: decode error: %v\n", raw, err)
            continue
        }
        // 查询语义下，+ 和 %20 都会得到空格；%2B 才得到加号。
        fmt.Printf("%q -> %q\n", raw, decoded)
    }
}

所以问题的关键不是“如何让函数别转换”，而是先确认原始值属于哪一种编码。若上游把普通文本直接塞进查询字符串，却没有把加号写成 %2B，接收端已经无法仅凭结果判断这个加号的原意。

先判断输入是不是查询编码

如果原始字符串来自表单字段、查询参数或 url.Values.Encode() 的结果，可以按查询语义解码。最稳妥的方式是让 url.ParseQuery 处理完整的键值对，而不是手动拆分后对每个片段做猜测。

package main

import (
    "fmt"
    "net/url"
)

func main() {
    rawQuery := "q=go%2Burl¬e=hello+world"
    values, err := url.ParseQuery(rawQuery)
    if err != nil {
        // 解析失败时不要把缺字段的结果当作成功请求。
        fmt.Println("invalid query:", err)
        return
    }

    // q 保留真实加号，note 按查询规则还原为空格。
    fmt.Printf("q=%q, note=%q\n", values.Get("q"), values.Get("note"))
}

这段输入中，q=go%2Burl 表示业务值为 go+url，note=hello+world 表示业务值为 hello world。不要在解析完成后再对结果做一次全局 ReplaceAll(" ", "+")，那会把真实空格重新伪装成加号。

查询参数、路径参数和编码函数怎么配对

加号问题最容易出现在“把路径当查询”处理的代码里。Go 官方文档指出，PathUnescape 与 QueryUnescape 的百分号解码行为相近，但不会把加号转为空格。路径片段中的 + 通常就是普通字符，不能套用表单查询规则。

例如资源地址是 /docs/go+url，它的路径文本包含真实加号；而 ?q=go+url 的加号属于查询编码语境。函数选错时，程序可能不报错，却把路由键、文件名或签名输入悄悄改掉。

错误处理和往返测试怎么做

QueryUnescape 遇到不完整或非法的百分号编码会返回错误，例如 %2 只有一个十六进制字符。生产代码应检查错误，测试则应覆盖空格、真实加号、百分号和非法输入四类情况。

package main

import (
    "fmt"
    "net/url"
)

func main() {
    original := "release+candidate 2"
    encoded := url.QueryEscape(original)
    restored, err := url.QueryUnescape(encoded)
    if err != nil {
        // 解码错误意味着输入协议或传输内容有问题。
        fmt.Println("round-trip failed:", err)
        return
    }
    // 成对使用同一查询编码规则，才能稳定还原原始文本。
    fmt.Printf("encoded=%q restored=%q\n", encoded, restored)
}

这类往返测试验证的是“由同一规则编码再解码”的契约，不代表任意历史字符串都能无损恢复。若数据经过了多次 URL 编码，要先明确每一层的责任，避免连续调用解码函数把合法的 %2B 继续拆掉。

Go QueryUnescape 加号常见问题

能不能把 QueryUnescape 换成 strings.ReplaceAll？

不建议。替换只能处理加号，不能正确处理百分号编码，也无法发现非法的 % 序列。应该先确认数据协议，再选择标准库函数。

为什么 QueryEscape 后的加号看起来不一样？

QueryEscape 会按查询编码生成可放进查询字符串的文本，空格和真实加号会使用不同表示。解码时只要使用对应的 QueryUnescape，就能按协议还原。

路径参数也能用 QueryUnescape 吗？

除非上游明确把路径片段当作表单查询编码，否则不要这样做。路径中的加号通常应保持为加号，优先使用 PathUnescape，并让路由层先明确参数边界。