HtmlAgilityPack报NullReferenceException主因是DocumentNode为空，需先判空；SelectNodes不支持CSS选择器而只认XPath；InnerText含多余空白和不可见字符，应预处理；新项目须用1.11.62+版本并避免单例复用。
HtmlAgilityPack 加载 HTML 时直接报 NullReferenceException
根本原因通常是 HtmlDocument.Load() 或 LoadHtml() 后没检查 DocumentNode 是否为空，尤其遇到网络请求返回空响应、HTML 片段缺失根节点（比如只有 <div>xxx</div>）、或编码不匹配导致解析中断时，DocumentNode 就是 null。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 永远先判断
doc.DocumentNode != null，再做后续查询 - 用
LoadHtml()解析片段时，加一层<html><body>...</body></html>包裹，避免节点树构建失败 - 如果从 HTTP 获取，优先用
WebClient或HttpClient拿到原始字符串后，显式指定编码（如Encoding.UTF8）再传给LoadHtml()，别依赖自动探测 - 示例：
var doc = new HtmlDocument(); doc.LoadHtml("<div class=\"title\">Hello</div>"); // ❌ 可能出 null // ✅ 改成： doc.LoadHtml("<html><body><div class=\"title\">Hello</div></body></html>");
用 SelectNodes() 查不到元素，但浏览器里明明有
常见于 CSS 类名含空格、特殊字符，或用了伪类（如 :nth-child），而 HtmlAgilityPack 的 XPath 引擎不支持 CSS 选择器或现代伪类——它只认 XPath 1.0。
实操建议：
立即学习“前端免费学习笔记（深入）”；
-
SelectNodes()参数必须是 XPath 表达式，不是 CSS 选择器。写"//div[@class='content']"可以，写"div.content"会静默返回空 - 类名含空格？XPath 中不能直接匹配完整
class属性值，得用contains(@class, 'xxx')，但要注意误匹配（如"highlight"会被"highlighted"匹配到） - 想精准匹配多类，用
normalize-space(@class) = 'a b'，但前提是 HTML 中 class 属性值顺序和空格完全一致 - 属性值含单引号？改用双引号包裹整个 XPath，或用
'转义，例如："//a[@href='http://example.com?k=v&s=1']"→ 改为"//a[@href=\"http://example.com?k=v&s=1\"]"
提取文本时多了换行、缩进、\u00A0（不间断空格）
InnerText 是“渲染后文本”的粗略模拟，会合并空白符但不清理 Unicode 空格、保留 <br> 换行逻辑，且对 <script>、<style> 内容也一并抓取。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 要干净文本，优先用
InnerHtml+ 正则清除标签，再用Regex.Replace(text, @"\s+", " ").Trim()压缩空白 - 过滤掉不可见字符：
text.Where(char.IsLetterOrDigit).ToArray()太激进，推荐Regex.Replace(text, @"[\u00A0\u2000-\u200F\u2028\u2029]+", " ") - 跳过脚本/样式内容：查节点前先
RemoveChild()掉所有script和style节点，或遍历Descendants()时跳过它们 - 示例：
foreach (var node in doc.DocumentNode.Descendants().Where(n => n.Name == "script" || n.Name == "style").ToArray()) node.Remove();
在 .NET Core / .NET 5+ 项目里 NuGet 安装后编译报错
HtmlAgilityPack 官方包（HtmlAgilityPack）已支持 .NET Standard 2.0，但老版本（如 1.4.x）不兼容新 SDK 风格项目，且某些平台（如 Unity、AOT 编译环境）会因反射调用被裁剪而失败。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 务必安装最新稳定版（目前是
1.11.62+），命令：dotnet add package HtmlAgilityPack - 若用
PackageReference方式，确认.csproj中没有残留的packages.config兼容配置 - 在 ASP.NET Core 中使用时，不要在
Startup.ConfigureServices()里注册单例HtmlDocument——它是无状态的，但非线程安全，每次解析都应新建实例 - 如果目标是轻量解析，且 HTML 规范、结构简单，可考虑用
System.Xml.Linq.XDocument.Parse()（配合XmlReaderSettings.DtdProcessing = DtdProcessing.Ignore）替代，省去第三方依赖
doc.PreserveWhitespace = false 和 doc.OptionFixNestedTags = true 开关试一遍，比硬调 XPath 更快定位问题。 
