goquery 不能直接解析本地文件或HTML字符串，必须通过io.Reader；NewDocument仅支持URL，传入文件路径会因协议错误失败；正确做法是用os.ReadFile读取后经strings.NewReader转为Reader再调用NewDocumentFromReader。
goquery 不能直接解析 HTML 字符串或文件路径，必须先转成 *http.Response 或 io.Reader —— 这是绝大多数人卡住的第一步。
为什么 doc, err := goquery.NewDocument("index.html") 总报错？
因为 NewDocument 只接受 URL（会发起 HTTP 请求），不接受本地文件路径或 HTML 字符串。它底层调用的是 http.Get，所以传入 "index.html" 会被当成域名访问，自然 DNS 失败。
- 正确做法：用
os.ReadFile读取文件内容，再用goquery.NewDocumentFromReader - 常见错误：把
"./index.html"直接塞进NewDocument，得到Get "./index.html": unsupported protocol scheme "" - 如果 HTML 来自网络响应，确保
resp.Body没被提前关闭或读取过 ——goquery需要可重读的io.Reader
htmlData, _ := os.ReadFile("./index.html")
doc, _ := goquery.NewDocumentFromReader(strings.NewReader(string(htmlData)))
Find() 找不到元素？检查选择器语法和文档加载状态
goquery 的选择器基于 CSS，但不支持所有浏览器级语法（比如 :has()、:nth-child(2n)），也不处理动态渲染内容 —— 它只解析静态 HTML DOM。
Golang Google Wire
下载
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
- 确保 HTML 已完整加载：如果从
http.Response创建，注意 Content-Type 是否为text/html，否则可能被当成纯文本解析 -
Find("div.content")匹配失败？试试Find("div").HasClass("content")或打印doc.Find("body").Html()看实际结构 - 嵌套查找别链式写错：
doc.Find("ul").Find("li")和doc.Find("ul li")行为一致；但doc.Find("ul").Children("li")只取直接子元素
中文乱码或标签名变成小写？设置正确的字符编码
goquery 默认用 UTF-8 解析，但如果 HTML 声明了 gbk 或 gb2312 却没转码，就会出现文字乱码、属性丢失、甚至 Find 失效（比如 class 属性读成空）。
立即学习“go语言免费学习笔记（深入）”；
- 手动指定编码：用
charset.NewReaderLabel（来自golang.org/x/net/html/charset）包装 reader - 不要依赖
<meta charset="gbk">自动识别 —— goquery 不解析 meta 标签来切换编码 - 常见现象：
doc.Find("标题").Length()返回 0，其实是标签名被解析成乱码导致匹配失败
reader := strings.NewReader(htmlStr)
reader, _ = charset.NewReaderLabel("gbk", reader)
doc, _ := goquery.NewDocumentFromReader(reader)
真正麻烦的不是语法，而是 HTML 源头是否干净、编码是否明确、结构是否符合预期 —— 很多时候问题不在 goquery，而在你拿到的那串字节到底是什么。
