Go语言net/url包提供安全标准的URL解析与构建能力，需区分*url.URL各字段用途并用url.Values管理查询参数；解析用url.Parse()后调用Query()获取解码参数，构建时应避免字符串拼接而用PathEscape()和Encode()确保编码安全。
Go语言的net/url包提供了安全、标准兼容的URL解析与构建能力，特别适合处理查询参数（query string）和路径（path）的增删改查。关键在于区分*url.URL结构体的各字段用途，并正确使用url.Values管理查询参数。
解析已有URL：提取协议、主机、路径和查询参数
使用url.Parse()可将字符串转为*url.URL对象。注意它不会自动解码路径或查询值，需手动调用Query()获取已解析的url.Values（本质是map[string][]string）。
示例：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
u, err := url.Parse("https://example.com/path/to?name=go&tag=golang&tag=web")
if err != nil {
log.Fatal(err)
}
fmt.Println(u.Scheme) // "https"
fmt.Println(u.Host) // "example.com"
fmt.Println(u.Path) // "/path/to"
fmt.Println(u.RawQuery) // "name=go&tag=golang&tag=web"
// 获取解码后的查询参数映射
values := u.Query()
fmt.Println(values.Get("name")) // "go"（取第一个值）
fmt.Println(values["tag"]) // ["golang" "web"]（所有值）
安全构建URL：避免手动拼接路径和查询
不要用字符串拼接构造URL，易出错且不安全（如未编码特殊字符）。应先创建空*url.URL，再设置字段，最后用url.Values生成查询字符串并赋给RawQuery。
立即学习“go语言免费学习笔记（深入）”；
- 路径使用
url.PathEscape()编码单个路径段（如文件名），但整个Path字段应保持已编码状态 - 查询参数统一用
url.Values管理，再调用.Encode()生成合法RawQuery
示例：
u := &url.URL{
Scheme: "https",
Host: "api.example.com",
Path: "/v1/users", // 已确保路径中/和字母数字外的字符已编码
}
// 构建查询参数
params := url.Values{}
params.Set("page", "1")
params.Add("sort", "name") // Add支持重复键
params.Add("sort", "updated")
u.RawQuery = params.Encode() // 自动编码并拼接为 "page=1&sort=name&sort=updated"
fmt.Println(u.String()) // https://api.example.com/v1/users?page=1&sort=name&sort=updated
增删改查查询参数：用url.Values统一操作
url.Values是操作查询参数的核心类型，提供Set、Add、Get、Del等方法，内部自动处理URL编码。
-
Set(k, v)：覆盖所有同名键，只保留一个值 -
Add(k, v)：追加值，支持同一键多个值（如多选标签） -
Get(k)：返回第一个值，键不存在时返回空字符串 -
Del(k)：删除该键所有值 -
Encode()：生成标准application/x-www-form-urlencoded字符串
注意：url.Values本身不保存原始URL，需手动同步回*url.URL.RawQuery。
处理路径段：编码与拼接要分开对待
路径中的斜杠/有语义（分隔层级），不能被url.PathEscape()编码；但路径段内含空格、中文、?等字符时必须编码。
推荐做法：
- 用
path.Join()拼接路径各段（它会处理多余/和开头/） - 对每个非固定路径段（如用户输入的用户名、文件名）单独调用
url.PathEscape() - 最终组合成完整
Path后，再赋值给*url.URL.Path
示例：
userName := "张三"
fileName := "report with spaces.pdf"
safeUser := url.PathEscape(userName) // "%E5%BC%A0%E4%B8%89"
safeFile := url.PathEscape(fileName) // "report%20with%20spaces.pdf"
fullPath := path.Join("/users", safeUser, "files", safeFile)
// → "/users/%E5%BC%A0%E4%B8%89/files/report%20with%20spaces.pdf"
u := &url.URL{Scheme: "https", Host: "example.com", Path: fullPath}
