url
net/url 包解析 URL 并实现查询字符串的转义。
解析 URL
package main
import (
"fmt"
"net/url"
)
func main() {
// 解析完整 URL
rawURL := "https://user:pass@example.com:8080/path/to/page?name=value&foo=bar#section"
u, err := url.Parse(rawURL)
if err != nil {
panic(err)
}
fmt.Printf("协议: %s\n", u.Scheme)
fmt.Printf("用户名: %s\n", u.User.Username())
password, _ := u.User.Password()
fmt.Printf("密码: %s\n", password)
fmt.Printf("主机: %s\n", u.Host)
fmt.Printf("主机名: %s\n", u.Hostname())
fmt.Printf("端口: %s\n", u.Port())
fmt.Printf("路径: %s\n", u.Path)
fmt.Printf("查询参数: %s\n", u.RawQuery)
fmt.Printf("片段: %s\n", u.Fragment)
}
处理查询参数
package main
import (
"fmt"
"net/url"
)
func main() {
// 解析查询字符串
query := "name=张三&age=25&hobby=编程&hobby=音乐"
values, err := url.ParseQuery(query)
if err != nil {
panic(err)
}
// 获取单个值
fmt.Printf("Name: %s\n", values.Get("name"))
fmt.Printf("Age: %s\n", values.Get("age"))
// 获取多个值(数组)
hobbies := values["hobby"]
fmt.Printf("Hobbies: %v\n", hobbies)
// 添加参数
values.Add("city", "北京")
fmt.Printf("Encoded: %s\n", values.Encode())
}
构建 URL
package main
import (
"fmt"
"net/url"
)
func main() {
// 构建 URL
u := &url.URL{
Scheme: "https",
Host: "api.example.com",
Path: "/v1/users",
}
// 添加查询参数
q := u.Query()
q.Set("page", "1")
q.Set("limit", "10")
q.Set("sort", "desc")
u.RawQuery = q.Encode()
fmt.Printf("完整 URL: %s\n", u.String())
// 使用简洁方式构建
params := url.Values{}
params.Set("key", "value with space")
params.Set("special", "hello&world")
u2, _ := url.Parse("https://example.com/search")
u2.RawQuery = params.Encode()
fmt.Printf("编码后: %s\n", u2.String())
}
URL 编码和解码
package main
import (
"fmt"
"net/url"
)
func main() {
// 编码
text := "Hello 世界! @#$%"
encoded := url.QueryEscape(text)
fmt.Printf("编码: %s\n", encoded)
// 解码
decoded, err := url.QueryUnescape(encoded)
if err != nil {
panic(err)
}
fmt.Printf("解码: %s\n", decoded)
// Path 编码(不编码空格为 +)
path := "/path/to/file name.txt"
pathEncoded := url.PathEscape(path)
fmt.Printf("Path 编码: %s\n", pathEncoded)
}
URL 解析和修改
package main
import (
"fmt"
"net/url"
)
func main() {
base, _ := url.Parse("https://example.com/api/v1/")
// 解析相对路径
rel, _ := url.Parse("users?page=1")
absolute := base.ResolveReference(rel)
fmt.Printf("绝对 URL: %s\n", absolute.String())
// 检查是否为绝对 URL
fmt.Printf("base 是绝对 URL: %v\n", base.IsAbs())
fmt.Printf("rel 是绝对 URL: %v\n", rel.IsAbs())
// 添加路径
base.Path = base.Path + "items"
fmt.Printf("修改后: %s\n", base.String())
}
实际应用示例
package main
import (
"fmt"
"net/url"
)
// BuildAPIURL 构建 API URL
func BuildAPIURL(baseURL, endpoint string, params map[string]string) (string, error) {
u, err := url.Parse(baseURL)
if err != nil {
return "", err
}
u.Path = u.Path + endpoint
q := u.Query()
for k, v := range params {
q.Set(k, v)
}
u.RawQuery = q.Encode()
return u.String(), nil
}
// ParseAPIResponse 解析 API 响应 URL
func ParseAPIResponse(rawURL string) (map[string]string, error) {
u, err := url.Parse(rawURL)
if err != nil {
return nil, err
}
result := make(map[string]string)
result["scheme"] = u.Scheme
result["host"] = u.Host
result["path"] = u.Path
// 解析查询参数
for key, values := range u.Query() {
if len(values) > 0 {
result[key] = values[0]
}
}
return result, nil
}
func main() {
// 构建 API URL
params := map[string]string{
"page": "1",
"limit": "20",
"sort": "created_at",
}
apiURL, _ := BuildAPIURL("https://api.example.com", "/users", params)
fmt.Printf("API URL: %s\n", apiURL)
// 解析 URL
parsed, _ := ParseAPIResponse(apiURL)
fmt.Printf("解析结果: %+v\n", parsed)
}
总结
| 功能 | 函数/方法 | 说明 |
|---|---|---|
| 解析 URL | url.Parse() |
解析 URL 字符串 |
| 解析查询 | url.ParseQuery() |
解析查询字符串 |
| 编码 | url.QueryEscape() |
查询字符串编码 |
| 解码 | url.QueryUnescape() |
查询字符串解码 |
| 构建查询 | url.Values |
构建查询参数 |
| 相对转绝对 | ResolveReference() |
相对 URL 转绝对 URL |
| 编码查询 | values.Encode() |
编码查询参数 |
处理 URL 时总是使用
url.Parse 而不是手动字符串拼接,这样可以正确处理特殊字符和编码问题。
🛒 站长推荐(京东联盟)
- 《Go 程序设计语言》(Go 语言圣经,机械工业出版社) —— Go 官方团队出品,公认入门第一书
- 《Go 语言实战》(异步图书,人民邮电出版社) —— 实战导向,面试前巩固工程手感
- 《Go 语言编程之旅:一起用 Go 做项目》(博文视点,电子工业出版社) —— 项目驱动入门,从零写出完整应用
- Keychron K1Max 矮轴机械键盘(Mac/Win 双系统,QMK/VIA 开源改键) —— 轻薄矮轴 + 开源固件,程序员桌面常客
- 罗技 MX Master 3S 无线鼠标(Flow 跨屏,静音电磁滚轮) —— 人体工学设计,写代码一整天手不酸
以上链接含京东联盟推广代码;通过链接购买本站可能获得少量佣金,不影响你的购买价格。
📮 关注公众号「Go2AI之路」
每周更新 Go + AI 应用开发实战:AI 面试官完整项目、MCP、Agent 工程化,完整源码随文章首发。
微信扫码,或搜索「Go2AI之路」关注,第一时间获取系列更新与源码,不再错过任何一篇。