goquery不能直接解析本地HTML字符串或文件路径，必须转为io.Reader；NewDocument仅支持URL并调用http.Get，传"index.html"会因协议错误失败，正确做法是os.ReadFile后经strings.NewReader转Reader再调NewDocumentFromReader。
goquery 不能直接解析本地 HTML 字符串或文件路径，必须转成 io.Reader；NewDocument 只发起 HTTP 请求，传 "index.html" 必报错——这是最常卡住的起点。
为什么 NewDocument("index.html") 总是失败
它底层调用 http.Get，把字符串当 URL 处理。传入相对路径或文件名会触发 Get "./index.html": unsupported protocol scheme ""。不是配置问题，是函数设计如此。
- 想读本地文件：用
os.ReadFile("./index.html")拿到字节切片，再套strings.NewReader(string(b))或bytes.NewReader(b) - 想读网络响应：必须在
http.Get后立刻用io.ReadAll(resp.Body)读取完整 body，再喂给NewDocumentFromReader；别直接传resp.Body，它可能已被关闭或不可重读 - 硬要用
file://协议？Linux/macOS 写file:///absolute/path/to/index.html，Windows 写file:///C:/path/index.html，且不保证所有环境支持
Find() 找不到元素的常见原因
不是选择器写错了，而是 DOM 根本没建起来，或结构和你预期不一致。
- 先确认 HTML 是否加载成功：
doc.Find("html").Length()返回 0？说明解析失败，大概率是 BOM（\xef\xbb\xbf）或编码问题 - 中文乱码、class 属性为空、
Find(".user-info")失效？检查原始字节流开头：fmt.Printf("% x", htmlBytes[:min(10, len(htmlBytes))])，看到ef bb bf就得用bytes.TrimPrefix(htmlBytes, []byte("\xef\xbb\xbf"))剥离 - GBK 页面必须手动转码：
charset.NewReaderLabel("gbk", bytes.NewReader(htmlBytes))包一层再传给NewDocumentFromReader -
Find("div.content")不如拆开验证：doc.Find("div").Each(func(i int, s *goquery.Selection) { fmt.Println(s.HasClass("content")) })
CSS 选择器的实际限制与写法细节
goquery 的选择器基于 net/html，不是浏览器引擎，很多前端习以为常的语法它不认。
立即学习“go语言免费学习笔记（深入）”；
- 不支持
:has()、:nth-child()、:contains()等 jQuery 扩展伪类 - 标签名一律小写：
Find("A")永远匹配不到，必须写Find("a")；SVG 元素需先Find("svg")再进子树查rect -
.user-info是一个 class 名，必须写成.user-info；多个 class 如class="a b c"要写成.a.b.c（表示同时含三个 class），不是.a .b .c（那是后代选择器） -
Find("ul").Children("li")只取ul的直接子li；Find("ul li")或Find("ul").Find("li")是后代查找，行为一致
Text() 返回空字符串的真相
这不是 bug，是 HTML 规范定义的行为：Text() 拼的是“渲染文本流”，而 <script>、<style>、注释节点本身不参与该流。
- 要取
<script>console.log(1)</script>里的内容，别用s.Text()，改用s.Nodes[0].FirstChild.Data（前提是只有一个文本子节点） - 通用安全写法：
strings.TrimSpace(s.Contents().Text())，Contents()包含所有子节点，再统一提取文本 - 需要保留换行或结构？用
s.Html()拿原始 HTML，再正则清理标签，或遍历s.Contents().Each()判断node.Type == html.TextNode
真正容易被忽略的是：BOM 和编码问题导致整个 DOM 树静默为空，Find 不报错也不匹配，调试时只看 err 是没用的，必须检查字节流开头和 Find("html").Length()。
