Go url.PathEscape 为什么没有编码斜杠

如果你直接调用 url.PathEscape("a/b")，斜杠应该变成 %2F。所以“PathEscape 没有编码斜杠”通常不是函数失效，而是把已经解析后的 URL.Path 当成了原始转义文本，或者把多个路径段先拼接后再观察。

官方文档：https://pkg.go.dev/net/url#PathEscape

先确认数据所处的位置：单个路径片段用 PathEscape，查询参数用 QueryEscape 或 url.Values，已经解析的 URL 要用 EscapedPath() 观察转义形式。不要用一个函数包办整条 URL。

先看 PathEscape 的直接结果

PathEscape 的语义是把字符串放进一个 URL path segment，也就是一个路径片段。片段内部的斜杠不能继续充当层级分隔符，因此会编码为 %2F。它不是把整条 URL 重新拼接或解析。

package main

import (
	"fmt"
	"net/url"
)

func main() {
	// 把斜杠当作单个路径片段中的普通字符。
	segment := url.PathEscape("a/b")
	fmt.Println(segment) // 输出 a%2Fb

	// 这里的斜杠位于两个路径片段之间，仍然是结构分隔符。
	path := "/users/" + url.PathEscape("a/b")
	fmt.Println(path) // 输出 /users/a%2Fb
}

第一行结果中的 %2F 是斜杠的百分号编码；第二行只保留手动加入的层级斜杠，用户数据里的斜杠仍在最后一个片段中被编码。

为什么 URL.Path 观察起来又有斜杠

解析 URL 后，URL.Path 保存的是解码后的路径。官方文档用 /foo%2fbar 说明：读 Path 时可能看到 /foo/bar，这不代表原始编码已经消失。需要保留编码形式时，优先调用 EscapedPath()；如果解析过程保留了有效的 RawPath，它也会参与输出。

package main

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

func main() {
	// 输入中明确写出 %2F，观察解析后的字段与重新转义的字段。
	u, err := url.Parse("https://example.com/foo%2fbar")
	if err != nil {
		// 解析失败时立即停止，避免继续使用不完整的 URL。
		log.Fatal(err)
	}

	fmt.Println("Path:", u.Path)                    // 解码视图：/foo/bar
	fmt.Println("RawPath:", u.RawPath)              // 编码提示：/foo%2fbar
	fmt.Println("EscapedPath:", u.EscapedPath())    // 转义视图：/foo%2fbar
	fmt.Println("URL:", u.String())                // 生成 URL 时使用转义路径
}

排查时不要只打印 Path。如果业务关心两个资源标识 foo/bar 与 foo%2Fbar 是否要区分，就要同时检查 EscapedPath() 和路由层的匹配规则。

路径参数和查询参数不要混用

同样的字符串放在不同 URL 位置，编码规则不同。路径片段需要保留层级语义，查询参数则有自己的空格、加号和保留字符规则。把 QueryEscape 当作路径片段编码器，或者把 PathEscape 用在整个查询串上，都会让结果难以解释。

package main

import (
	"fmt"
	"net/url"
)

func main() {
	value := "a/b+c"

	// 路径片段中的斜杠要失去层级含义。
	fmt.Println("path:", url.PathEscape(value))

	// 查询参数由 Values 统一编码，避免手动处理多个键值。
	query := url.Values{}
	query.Set("q", value)
	fmt.Println("query:", query.Encode())
}

如果是在构造完整请求 URL，先解析基础 URL，再设置路径或查询字段通常比直接拼字符串更清楚。路径段边界由调用方保留，片段内容由 PathEscape 处理，查询部分交给 url.Values。

手动拼接和 JoinPath 的边界

最常见的错误有两类：一是把整条 URL 传给 PathEscape，结果连协议、主机和分隔符都被当成片段内容；二是把已经含有 %2F 的字符串再次转义，得到 %252F。编码要发生在“原始值进入哪个 URL 位置”这一刻，而不是在每一层函数里反复处理。

package main

import (
	"fmt"
	"net/url"
)

func main() {
	// 只转义原始 ID，不要转义已经拼好的整条 URL。
	id := url.PathEscape("a/b")
	base := "https://example.com/users/"
	fmt.Println(base + id)

	// 已经是 %2F 的文本再次转义，会把百分号本身编码成 %25。
	encodedAgain := url.PathEscape(id)
	fmt.Println(encodedAgain) // 输出 a%252Fb
}

如果使用 url.JoinPath，传入的元素也应当已经是适合路径拼接的转义形式；不要把同一个片段在调用前后各编码一次。对已有 URL 对象，输出时使用 String 或 RequestURI，观察时使用 EscapedPath。

遇到“斜杠没编码”时按这个顺序排查

1. 先看调用对象。 确认调用的是 url.PathEscape(rawSegment)，而不是打印 u.Path。
2. 再看数据位置。 路径片段、查询值、主机名和整条 URL 不能共用同一种转义方法。
3. 检查是否已解析。 对 url.Parse 的结果同时打印 Path、RawPath 和 EscapedPath()。
4. 排除重复编码。 输入如果已经含有 %2F，不要再次调用 PathEscape。
5. 最后看路由约定。 有些服务器或框架会在路由匹配前解码路径，是否把编码斜杠当作层级分隔符要由服务端规则决定。

一句话总结：PathEscape 直接处理路径片段时会编码斜杠；真正容易误判的地方是把解码字段当成原始 URL、把结构分隔符和片段内容混在一起，或重复执行编码。

常见问题

PathEscape("a/b") 的结果应该是什么？

应当包含 a%2Fb，因为片段内部的斜杠需要失去路径层级含义。

为什么打印 URL.Path 不是 %2F？

URL.Path 是解析后的解码视图；想看转义形式应使用 EscapedPath()，并按需查看 RawPath。

查询参数也能用 PathEscape 吗？

不建议。查询参数应使用 url.Values 或适用于查询的编码逻辑，路径片段和查询值的保留字符规则不同。