url

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() 编码查询参数
🛒 站长推荐(京东联盟)

以上链接含京东联盟推广代码;通过链接购买本站可能获得少量佣金,不影响你的购买价格。

📮 关注公众号「Go2AI之路」
Go2AI之路 公众号二维码

每周更新 Go + AI 应用开发实战:AI 面试官完整项目、MCP、Agent 工程化,完整源码随文章首发。

微信扫码,或搜索「Go2AI之路」关注,第一时间获取系列更新与源码,不再错过任何一篇。

wx

关注公众号

©2017-2026 鲁ICP备17023316号-1 Powered by Hugo · 隐私政策