goquery不能直接解析本地文件或html字符串，必须通过io.reader；newdocument仅支持url，传文件路径会因协议错误失败，正确做法是os.readfile后经strings.newreader转为reader再调newdocumentfromreader。

goquery 不能直接解析本地文件路径或 HTML 字符串，传错类型会静默失败或 panic —— 这是 90% 的人卡住的第一步。

goquery.NewDocument("index.html") 为什么总报错？

因为 NewDocument 只接受 URL 字符串，并内部调用 http.Get 发起网络请求。传入 "index.html" 或 "./index.html" 会被当成域名解析，触发 Get "./index.html": unsupported protocol scheme "" 错误。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

• 正确做法：用 os.ReadFile 读取文件内容，再经 strings.NewReader 或 bytes.NewReader 转为 io.Reader，最后调用 NewDocumentFromReader
• 若硬要用 file:// 协议，必须写绝对路径（macOS/Linux： "file:///path/to/index.html"；Windows："file:///C:/path/index.html"），且系统需支持该协议
• 从 HTTP 响应创建时，确保 resp.Body 没被提前读取或关闭 —— NewDocumentFromReader 需要可重读的 reader

Find() 找不到元素？先看 HTML 是否被正确加载和编码

Find() 基于 CSS 选择器，但底层依赖 net/html 解析结果。如果原始字节流有 BOM、编码不匹配或结构异常，DOM 树可能为空或错乱，导致查找失效。

• UTF-8 BOM（\xef\xbb\xbf）会导致 LoadHTMLString 静默跳过开头标签，返回空文档；用 bytes.TrimPrefix(htmlBytes, []byte("\xef\xbb\xbf")) 剥离后再解析
• GBK/GB2312 页面必须手动转码，goquery 不解析 <meta charset="gbk">锛涙帹鑽愮敤 charset.NewReaderLabel 鍖呰

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！