PathEscape仅编码路径中非法或特殊字符（如空格、中文、€等），但保留A-Z、a-z、0-9、-、.、_、~和/；它不编码/，故"a/b"返回"a/b"而非"a%2Fb"。
PathEscape 会编码哪些字符
net/url.PathEscape 只对路径中「不允许出现」或「有特殊含义」的字符做百分号编码，比如 /、?、#、 （空格）、中文、€ 等。它**不会编码**路径分隔符 / 本身——这是关键点，很多人误以为它会把整个字符串当普通字符串处理，结果发现 / 没被转义，拼出来的 URL 出错。
它保留 A-Z、a-z、0-9、-、.、_、~ 和 /（注意这个斜杠），其余一律编码。所以 PathEscape("a/b") 返回 "a/b"，不是 "a%2Fb"。
什么时候该用 PathEscape，而不是 QueryEscape
区分场景：如果你在构造 URL 路径段（path segment），比如 /api/v1/users/张三 中的 张三，就用 PathEscape；如果是在 query string 里，比如 ?name=张三&sort=desc 中的值，就得用 net/url.QueryEscape。
QueryEscape 会把 / 编成 %2F，而 PathEscape 不会——这正是它适合路径段的原因。但反过来说，你绝不能用 PathEscape 去编码整个 URL 字符串，也不能拿它去编码 query value，否则 &、= 这些不会被处理，导致参数解析失败。
- ✅ 正确：
"/users/" + url.PathEscape(username) - ❌ 错误：
"?name=" + url.PathEscape(username)（应改用QueryEscape） - ❌ 错误：
url.PathEscape("/api/v1/users")（整段路径不需要逃逸，/本就是合法分隔符）
常见错误：直接拼接导致路径被截断
最典型的坑是把带 / 的用户输入（比如文件名 "dir/file.txt"）直接喂给 PathEscape，然后拼进路径："/files/" + url.PathEscape("dir/file.txt") → "/files/dir/file.txt"。服务器收到后，会认为这是三级路径 /files/dir/file.txt，而不是一个叫 "dir/file.txt" 的文件名。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
这时候你需要的是「将整个路径段视为原子单位」，但 PathEscape 不负责层级语义。解决方案取决于你的服务端路由设计：
- 如果后端支持路径通配（如
GET /files/{filename...}），那没问题 - 否则，应先用
filepath.Base提取文件名，或用strings.ReplaceAll(name, "/", "%2F")强制编码斜杠（但这已超出PathEscape职责） - 更稳妥的做法：避免让用户控制含
/的路径段，改用 query 参数传原始名：/files?name=dir%2Ffile.txt
和 url.JoinPath 的配合使用
Go 1.19+ 提供了 url.JoinPath，它内部会自动对每个参数调用 PathEscape，并安全拼接。推荐优先用它代替手拼：
u, _ := url.JoinPath("https://api.example.com", "v1", "users", username)
// 等价于逐个 PathEscape 后用 "/" 连接，且不重复编码已转义的部分
注意：JoinPath 第一个参数如果是完整 URL（含 scheme），它会解析并替换 path；如果只是路径前缀（如 "v1"），就纯拼接。它不会帮你处理 query 或 fragment，那些仍得手动加。
别忘了：只要有一个参数含未转义的 /，JoinPath 就会把它当路径分隔符切开——所以仍需确保每个参数是干净的路径段，不要传 "user/name" 这种。
