本文介绍两种主流方法：使用标准库 net/url.ParseQuery 解析标准 HTTP 查询字符串（推荐），以及手动按 & 和 = 分割实现轻量级键值对映射，涵盖空值处理、URL 解码、边界情况与安全注意事项。
本文介绍两种主流方法：使用标准库 `net/url.parsequery` 解析标准 http 查询字符串（推荐），以及手动按 `&` 和 `=` 分割实现轻量级键值对映射，涵盖空值处理、url 解码、边界情况与安全注意事项。
在 Go 中将形如 "A=B&C=D&E=F" 的字符串解析为 map[string]string，最可靠且符合工程实践的方式是优先使用标准库 net/url.ParseQuery——它专为解析 URL 查询字符串设计，自动处理 URL 编码（如 %20、%3D）、重复键、空值及各类边缘 case。仅当明确需绕过解码、忽略编码规范或处理非标准格式时，才考虑手动分割。
✅ 推荐方式：使用 url.ParseQuery
package main
import (
"fmt"
"net/url"
)
func main() {
s := "A=B&C=D&E=F&name=%E4%BD%A0%E5%A5%BD&empty=&foo" // 包含中文、空值、无值键
values, err := url.ParseQuery(s)
if err != nil {
panic(err)
}
// 转换为 map[string]string（取每个键的第一个值，符合常见语义）
m := make(map[string]string)
for k, v := range values {
m[k] = ""
if len(v) > 0 {
m[k] = v[0] // url.Values 是 map[string][]string，取首值
}
}
fmt.Println(m)
// 输出: map[A:B C:D E:F empty: name:你好 foo:]
}
⚠️ 注意：url.ParseQuery 返回 url.Values（即 map[string][]string），因为 HTTP 允许同一键多次出现（如 ?tag=go&tag=web）。若业务要求“单值覆盖”，取 v[0] 即可；若需保留多值，请直接使用 url.Values。
? 手动分割（仅限简单、可信、无编码的场景）
若字符串确定为纯 ASCII、无 URL 编码、无空格且格式严格（如内部协议），可手动解析：
package main
import (
"fmt"
"strings"
)
func parseSimpleQuery(s string) map[string]string {
result := make(map[string]string)
pairs := strings.Split(s, "&")
for _, pair := range pairs {
if pair == "" {
continue
}
kv := strings.SplitN(pair, "=", 2) // 最多切两段，避免 "=" 出现在 value 中被误切
key := strings.TrimSpace(kv[0])
var value string
if len(kv) == 2 {
value = strings.TrimSpace(kv[1])
}
result[key] = value
}
return result
}
func main() {
s := "A=B&C=D&E=F&empty=&no-value"
m := parseSimpleQuery(s)
fmt.Println(m)
// 输出: map[A:B C:D D:F empty: no-value:]
}
? 关键差异与选型建议
| 特性 | url.ParseQuery | 手动 strings.Split |
|---|---|---|
| URL 解码 | ✅ 自动解码（%20 → ' '） | ❌ 原样保留 |
| 空值处理（key=） | ✅ 值为空字符串 "" | ✅（需显式判断 len(kv)==2） |
| 无值键（key） | ✅ 值为空字符串 "" | ✅（kv[1] 不存在时设 ""） |
| 多值支持 | ✅ []string，天然支持重复键 | ❌ 覆盖前值（最后出现者胜出） |
| 安全性 | ✅ 防止注入、兼容 RFC 3986 | ❌ 不校验，易受畸形输入影响 |
| 性能 | ⚠️ 略低（含解码开销），但通常可忽略 | ✅ 极简，零分配（小字符串场景） |
✅ 总结
- 默认选择 url.ParseQuery：它是 Go 标准库为该问题提供的权威解决方案，健壮、安全、符合 Web 规范；
- 手动解析仅作特殊用途：如嵌入式环境、性能敏感且输入完全可控的场景，务必自行处理空指针、边界切片和 Unicode 空格；
- 永远不要在生产 HTTP 服务中手动解析查询字符串——这会绕过关键的安全与兼容性保障。
正确选用工具，让代码既简洁又可靠。
