HtmlAgilityPack跨文档追加节点会修改原始源文档吗？

你的排查思路完全正确，这不是环境异常或者组件bug，是HtmlAgilityPack（下文简称HAP）的默认DOM操作逻辑，和浏览器原生DOM的行为一致：

• 所有HtmlNode实例都和所属DOM树绑定，同一时间一个节点只能挂载在一个父节点下
• 直接调用AppendChild/PrependChild等方法添加属于其他DOM树的节点时，HAP会自动将该节点从原父节点下移除，再挂载到新的父节点下，本质是「剪切」操作，不是「复制」操作
• 节点的ParentNode是只读属性，无法手动赋值为null，节点的父子关系只能通过官方提供的DOM操作方法（AppendChild/Remove/RemoveChild等）修改，这也是你没法手动清空父引用的原因。

你观察到源文档子节点数量减少，就是节点被自动从原位置剪切走导致的。

如果你需要保留源文档的DOM结构不被修改，必须先对要迁移的节点做克隆，再把克隆后的节点追加到目标文档。

修正后的代码 #

把原代码里追加节点的逻辑替换成下面的写法即可：

// 先从源文档取到目标节点
var sourceHeader = siToc.DocumentNode.SelectSingleNode("/html/body/div[@class=\"page_header\"]");
// 深克隆节点：参数传true表示复制节点本身+所有子节点、属性、嵌套内容；传false仅复制当前空节点
var clonedHeader = sourceHeader.CloneNode(true);
// 追加克隆后的节点到目标文档，不会影响源文档结构
outputBody.AppendChild(clonedHeader);

补充说明 #

• 你提到单步调试时移走1个节点，源文档body下子节点从3个变成1个，和预期的剩2个不符，建议断点检查剩余节点的内容，大概率是测试过程中其他节点操作导致的偏差，核心的节点剪切逻辑不会出错。
• 这个行为和HAP版本、.NET版本无关，所有正式发布的HAP版本都遵循这个DOM操作规则，和你用的.NET 5、VS2022环境没有关系，任意合法HTML文档都会复现这个现象。

内容的提问来源于stack exchange，提问作者Coyttl