必须先滚动到底部并等待动态内容加载完成再截图，否则会截半；推荐用WaitForNetworkIdleAsync或WaitForSelectorAsync等待，避免Thread.Sleep；FullPage参数对JS渲染页面效果有限，超长页需手动滚动+分段截图合成。
用 PuppeteerSharp 截长图必须等滚动到底部再截图
直接调用 page.screenshotasync() 默认只截当前视口，不是整页。想截完整网页，得先让页面滚动到最底，再等所有动态内容（比如懒加载图片、无限滚动区块）加载完，最后才截图。
常见错误是滚动后立刻截图，结果底部空白或缺内容。关键不是“滚多少次”，而是“等什么条件”。推荐监听 NetworkIdle 或自定义等待元素出现：
-
await page.WaitForNetworkIdleAsync(new WaitForNetworkIdleOptions { Timeout = 10000 });—— 适合常规网站，等网络请求静默 10 秒 -
await page.WaitForSelectorAsync("footer", new WaitForSelectorOptions { Timeout = 5000 });—— 更可靠，尤其当页脚是最后渲染的 DOM 节点 - 避免用固定
Thread.Sleep()，不同网速/设备下不稳定
PuppeteerSharp 滚动到页面底部的三种写法及适用场景
无头浏览器不支持原生“滚动到底”API，得靠 Page.EvaluateAsync() 执行 JS。三种常用方式差异明显：
-
await page.EvaluateAsync("window.scrollTo(0, document.body.scrollHeight)");—— 简单粗暴，但可能漏掉 footer 外的浮动层或 sticky 元素 -
await page.EvaluateAsync("document.documentElement.scrollTop = document.documentElement.scrollHeight");—— 更准，优先用documentElement而非body，兼容 Chrome/Firefox 渲染差异 -
await page.EvaluateAsync("document.querySelector('main')?.scrollIntoView({block: 'end'});");—— 精准控制，适合已知主体容器名的 SPA 页面
注意：滚动后务必接等待逻辑（见上一节），否则截图仍是“半截”。
生成全页 PNG 时 FullPage 参数的实际行为
Page.ScreenshotAsync() 的 FullPage 选项常被误解为“自动滚动+截图”。它确实会尝试拼接视口，但有硬限制：
Comet AI 浏览器
下载
下载 Comet AI 浏览器，体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作，让 AI 成为你的浏览副驾，大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。
- 只对静态 HTML 有效；遇到 JS 渲染内容（如 React/Vue 动态列表），仍可能截断
- 某些 CSS
position: fixed或transform元素在拼接时错位甚至消失 - 内存占用高，超长页面（>10000px）易触发 OOM 或超时，建议配合
Timeout和Clip分段处理
实测中，FullPage = true + WaitForNetworkIdleAsync 组合能覆盖 70% 场景；剩下 30% 必须手动滚动+截图+合成（用 SkiaSharp 或 ImageMagick 拼接）。
截长图失败时最该查的三个地方
报错不明确？截图黑/白/截半？优先检查：
-
page.UserAgent是否被识别为爬虫而返回空页 —— 加一句await page.SetUserAgentAsync("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"); - 目标页面是否用
IntersectionObserver控制懒加载 —— 若是，需滚动后多等 200ms 再触发WaitForSelectorAsync -
LaunchOptions是否禁用了图片加载：Args = new[] { "--blink-settings=imagesEnabled=false" }—— 关掉它，否则懒加载图永远不出现
真正卡住的时候，别急着换库，先开 Headless = false 看一眼浏览器实际渲染状态 —— 很多问题肉眼 3 秒就能定位。
