URL解析失败时需检查RawQuery和Fragment是否被截断；未编码的#、&、=会导致字段错位，应提前用url.QueryEscape或url.PathEscape对相应部分转义，修改url.URL后必须调用String()生成新URL。
URL解析失败时检查RawQuery和Fragment是否被意外截断
Go 的 url.Parse 默认会把 # 后面的内容当作 Fragment，而 ? 后面直到 # 前的部分归入 RawQuery。如果原始 URL 里有未编码的 &、= 或 #，解析后字段可能错位——比如本该在查询参数里的 name=foo#bar 被拆成 RawQuery="name=foo" 和 Fragment="bar"，但实际你想保留 # 作为参数值。
- 先用
strings.Contains检查原始字符串是否有未编码的特殊字符 - 若需保留字面量（如 API 返回含
#的参数值），应提前对整个查询部分做url.PathEscape，再拼接 -
url.Parse不校验查询参数格式，所以?a&b=c会被接受，但Query()方法返回的url.Values里a对应空字符串，b才是c
用url.QueryEscape还是url.PathEscape？看位置
这两个函数逃逸规则不同：QueryEscape 把空格转成 +，且不编码 /、?；PathEscape 把空格转成 %20，并严格编码所有非 URL path 字符（包括 /）。选错会导致 400 或路由匹配失败。
- 查询参数值（
?q=xxx中的xxx）用url.QueryEscape - 路径段（
/user/xxx中的xxx）必须用url.PathEscape，否则/不会被编码，服务器可能误判层级 - 不要对整个 URL 字符串调用任一 escape 函数——它们只设计用于单个字段
url.URL结构体修改后必须调用String()才能生成新URL
url.URL 是值类型，字段可直接赋值（如 u.Scheme = "https"），但这些修改不会自动同步到最终字符串表示中。Go 不重载 + 或隐式转换，也没有“构建器”方法。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 改完
Host、Path、RawQuery等字段后，必须显式调用u.String()才能得到完整 URL 字符串 -
RawQuery需要手动拼接键值对，url.Values的Encode()方法输出的是a=b&c=d格式，可直接赋给RawQuery - 如果只改了
Fragment却忘了调用String()，打印u仍显示旧值（因为fmt.Printf("%v", u)输出结构体字段快照，不是动态生成）
中文路径或参数在服务端收不到？检查Content-Type和Accept-Charset
Go 编码中文没问题：url.PathEscape("你好") 得到 %E4%BD%A0%E5%A5%BD，但某些 HTTP 服务（尤其是老旧 PHP 或 Nginx 配置）默认不处理 UTF-8 路径，或要求请求头声明字符集。
立即学习“go语言免费学习笔记（深入）”；
- 确保客户端请求头包含
Accept-Charset: utf-8（虽非强制，但部分网关会据此解码） - 服务端若用
net/http，r.URL.Path已自动解码为 UTF-8 字符串，无需再url.PathUnescape - 如果服务端是其他语言（如 Java Spring），确认其是否启用
URIEncoding="UTF-8"（Tomcat）或等效配置，否则%E4%BD%A0可能被当乱码丢弃
url.Parse，再改 RawQuery（用 url.Values{}.Set().Encode()），最后 String()。最容易漏的是最后一步——写完字段就直接传给 http.Get，结果发出去的还是原始 URL。 
