路径段必须用url.PathEscape而非url.QueryEscape，因其保留/等路径语义字符，仅编码中文、空格、冒号等危险字符，且空格转%20而非+；错误混用会导致路由匹配失败或404。
路径段必须用 url.PathEscape，不是 url.QueryEscape
中文、空格、斜杠、冒号等字符直接塞进 URL 路径（比如 /api/user/张三）会导致 404 或路由匹配失败——因为 HTTP 服务器和 Go 框架（如 Gin、Echo）默认把路径按 / 分割后，再对每个段做语义解析。如果没编码，张三 可能被截断或触发非法字符拒绝；如果错用 url.QueryEscape，/ 会变成 %2F，而多数框架不自动解码路径里的 %2F，结果 /user/张%2F三 根本匹配不到 /user/{name}。
正确做法是：只对「单个路径段」调用 url.PathEscape，它保留路径结构语义，只转义该段内的危险字符：
-
url.PathEscape("张三")→%E5%BC%A0%E4%B8%89（中文正常） -
url.PathEscape("user/name")→user%2Fname（/被编码，但仍是合法路径段） -
url.PathEscape("foo:bar")→foo%3Abar（冒号也被处理） - 空格变成
%20，不是+—— 这是和 query 编码的根本区别
拼完整路径时，先分段再拼接，别对整个字符串调用 url.PathEscape
路径不是扁平字符串，它是有层级的：/files/用户上传/abc.txt 包含三个段：files、用户上传、abc.txt。如果直接 url.PathEscape("/files/用户上传/abc.txt")，开头的 / 会被编码成 %2F，导致生成 %2Ffiles%2F%E7%94%A8%E6%88%B7%E4%B8%8A%E4%BC%A0%2Fabc.txt，这不是合法路径格式，HTTP 客户端可能直接报错。
正确顺序是：
立即学习“go语言免费学习笔记（深入）”；
- 用
strings.Split或手动拆成段（不含开头/） - 对每个段单独调用
url.PathEscape - 用
path.Join或strings.Join(..., "/")拼回，再补前导/
示例：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
segments := []string{"files", "用户上传", "abc.txt"}
escaped := make([]string, len(segments))
for i, s := range segments {
escaped[i] = url.PathEscape(s)
}
fullPath := "/" + strings.Join(escaped, "/") // → "/files/%E7%94%A8%E6%88%B7%E4%B8%8A%E4%BC%A0/abc.txt"解码时必须用 url.PathUnescape，且要检查 error
收到请求后，若从 r.URL.Path 提取路径段（比如 "用户上传" 对应的原始值是 %E7%94%A8%E6%88%B7%E4%B8%8A%E4%BC%A0），不能直接用 url.QueryUnescape —— 它会把 + 当空格，而路径中没有 + 表示空格的约定，容易错解。
而且生产环境里，用户可能传畸形编码串（如 %xz、孤立 %、非法 UTF-8 字节），忽略错误会导致后续 panic 或逻辑错乱：
- 必须显式检查
err：decoded, err := url.PathUnescape(encoded); if err != nil { /* 拒绝请求 */ } - 不要循环多次解码：路径编码只应是一层，重复解码反而可能引入绕过风险
- 解码后建议再做一次
filepath.Clean（如果用于文件系统路径），但注意：必须先PathUnescape再Clean，否则%2e%2e类编码无法识别
中文路径在反向代理或 CDN 后容易被二次解码
某些 Nginx 配置、Cloudflare 或自建反向代理会在转发前自动解码一次路径，而你的 Go 服务又调用了一次 PathUnescape，结果就是双重解码 —— %E5%BC%A0 先变 张，再被当普通字符串再次解码，触发 error 或乱码。
应对方式很实际：
- 先确认你上游有没有自动解码行为（查
nginx.conf是否开了underscores_in_headers on或用了rewrite规则） - 如果存在，Go 层就跳过
PathUnescape，直接用原始r.URL.Path分段处理 - 更稳妥的做法：统一在入口处记录原始
r.URL.RequestURI()和r.URL.Path，比对二者是否一致 —— 若不一致，说明已被上游解码过
路径编码这件事，错一层就全错。关键不是“有没有编码”，而是“在哪一层、对哪一段、用哪个函数、解几次”。
