最安全的方式是使用 url.Values 构建查询字符串，它自动调用 url.QueryEscape 编码每个值，避免手动拼接导致的中文、空格、特殊符号编码错误；需用 Set()/Add() 填充参数后调用 .Encode() 生成标准格式字符串。
用 url.Values 构建查询字符串最安全
手动拼接 ?key=value&key2=value2 看似简单，但容易出错：中文、空格、特殊符号（如 &、=）不编码会导致请求失败或服务端解析错误。Go 标准库的 url.Values 专为这事设计，它自动调用 url.QueryEscape 编码每个值。
实操建议：
- 先声明
url.Values{}，用Set()或Add()填充参数（Set()覆盖同名键，Add()支持重复键） - 调用
.Encode()得到已编码的字符串，直接拼到 URL 后面即可 - 不要自己用
fmt.Sprintf拼接，也不要用字符串+连接未编码的值
params := url.Values{}
params.Set("q", "Go语言 教程")
params.Set("page", "1")
fullURL := "https://api.example.com/search?" + params.Encode()
// 结果：https://api.example.com/search?q=Go%E8%AF%AD%E8%A8%80+%E6%95%99%E7%A8%8B&page=1
GET 请求中直接传 url.URL 更可靠
如果用 http.Get() 或 http.NewRequest() 发起请求，推荐先构造完整的 *url.URL 对象，再传给请求函数。这样能避免 URL 解析歧义，尤其当原始 URL 已含路径或已有部分 query 时。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
- 原始 URL 带问号但没参数（如
https://a.com/?），再手动拼?k=v会变成??k=v - 原始 URL 已有 query（如
https://a.com?from=web），直接+新参数会丢失原有参数或格式错乱
正确做法是复用 url.Parse() 解析原地址，修改其 .RawQuery 字段：
u, _ := url.Parse("https://api.example.com/search")
u.RawQuery = url.Values{"q": {"Go"}, "limit": {"10"}}.Encode()
req, _ := http.NewRequest("GET", u.String(), nil)
POST 表单请求也要用 url.Values 作 body
虽然标题说的是“带 Query 参数的请求”，但很多人实际想发的是表单类 POST（Content-Type: application/x-www-form-urlencoded）。这类请求的参数不在 URL 里，而在请求体中，同样必须用 url.Values 编码 —— 直接写字符串或 JSON 都会触发 400 错误。
关键点：
-
url.Values的Encode()输出就是标准表单格式，可直接作bytes.Reader传入http.Post() - 务必设置请求头：
req.Header.Set("Content-Type", "application/x-www-form-urlencoded") - 别把 POST 参数塞进 URL query，后端通常不从那里读表单数据
data := url.Values{}
data.Set("username", "admin")
data.Set("token", "x y+z") // 自动编码成 x+y%2Bz
resp, _ := http.Post("https://api.example.com/login", "application/x-www-form-urlencoded", strings.NewReader(data.Encode()))
注意 url.ParseQuery 只用于解析，不能反向生成
有人看到 url.ParseQuery("a=1&b=2") 返回 url.Values，就以为它也能把 url.Values 变回字符串 —— 实际上不能。ParseQuery 是单向解析函数，且只接受纯 query 字符串（不含 ?）。生成 query 必须用 url.Values.Encode()。
容易踩的坑：
- 对已编码的字符串再调一次
Encode()，导致双重编码（例如%20变成%2520） - 误用
url.QueryEscape处理整个key=value&key2=value2字符串，这会把&和=也编码，破坏结构 - 把 map 直接传给
Encode()—— 它只认url.Values类型，不是普通 map
复杂点在于：query 编码规则和表单提交规则一致，但语义不同；同一套编码逻辑用在 URL path、query、form body 时，边界处理略有差异，靠手写永远不可靠。坚持用 url.Values 是唯一省心方式。
