urls.PathUnescape
返回给定字符串,并把所有百分号编码序列替换为对应的未转义字符。
这一页解决什么问题
从 URL、href、数据文件里拿到的是已编码的片段:my%20caf%C3%A9、%E4%B8%AD%E6%96%87。想把它显示给读者,或想用解码后的值去查数据,就要还原成原来的文本。urls.PathUnescape 做的是 urls.PathEscape 的逆变换。
什么时候用,什么时候别用
该用:
- 显示从 URL 取来的片段(文件名、术语名);
- 解码后用解码结果去查映射、做比较。
别用:
- 要编码 → 用
urls.PathEscape; - 解析整条 URL 并分别取各部分(路径、查询、片段)→ 用
urls.Parse:它已经按部分给好了解码前后的字段; - 想把百分号编码的 URL 变回站点路径 → 直接用解析结果里的字段,而不是对整条 URL 解码。
用法
(0.153.0 新增)
urls.PathUnescape 函数执行 urls.PathEscape 的逆变换。
go-html-template
{{ urls.PathUnescape "A%2Fb%2Fc%3Fd=%C3%A9&f=g+h" }} → A/b/c?d=é&f=g+h用该函数解码 URL 路径中的单个片段。
完整示例(实测)
layouts/_partials/decode.htmlgo-html-template
[{{ urls.PathUnescape "A%2Fb%2Fc%3Fd=%C3%A9&f=g+h" }}]|[{{ urls.PathUnescape (urls.PathEscape "中文 标签") }}]Hugo 0.167.0 实测输出(原始值里的 & 在网页中显示为 &,+ 显示为 +):
[A/b/c?d=é&f=g+h]|[中文 标签]你应当看到什么:第一项把 %2F、%3F、%C3%A9 分别还原成 /、?、é;注意 + 原样保留——本函数做的是路径解码,不会把 + 变成空格。第二项验证「先编码再解码」能拿回原文。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点(locale = 'zh-CN'),Windows。
| 输入 | 结果 | 是否报错 |
|---|---|---|
"A%2Fb%2Fc%3Fd=%C3%A9&f=g+h" |
A/b/c?d=é&f=g+h(+ 不变空格) |
否 |
urls.PathUnescape (urls.PathEscape "中文 标签") |
中文 标签(与原文完全一致) |
否 |
不含 % 的普通字符串 |
原样返回 | 否 |
非法的百分号序列(如 %ZZ) |
上游未说明 | 上游未说明 |
| 返回类型 | string |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | 查询串里的 + 没有变成空格 |
本函数是路径解码,+ 在路径里不是空格的转义 |
查询串场景请用 urls.Parse 得到的 Query,它按查询语义解析 |
| 没报错但结果不对 | 解码结果仍带 % |
原文是双重编码 | 再解一次,或在源头修掉重复编码 |
| 没报错但结果不对 | 解码后拿到 A/b/c 却想当成一个片段 |
编码前没有把 / 编成 %2F(或用的是不会编码 / 的方式) |
编码用 urls.PathEscape(实测它会把 / 编成 %2F) |
更多排查入口见故障排查。