cefsharp需严格遵循生命周期规范：main()中先调用cef.initialize()并传入multithreadedmessageloop=true，平台目标设x64/x86，确保libcef.dll等文件存在且路径正确；加载页面用load()而非url属性；js与c#交互须等待isbrowserinitializedchanged或frameloadend事件触发，并注意线程切换与资源清理。
CefSharp 不是 WebBrowser 控件的平替，它是一套独立进程模型，初始化失败、JS 调用静默丢弃、白屏卡死——这些不是 bug，而是没踩对启动和交互生命周期。
Program.Main() 必须最先调用 Cef.Initialize()
WinForms 或 WPF 启动时，Cef.Initialize() 一定要在 Application.Run() 或 Application.Current.Run() 之前执行，且不能包裹在窗体构造函数或 Load 事件里。否则浏览器控件创建时找不到运行时，直接抛 System.DllNotFoundException: Unable to load DLL 'libcef' 或黑屏。
- 必须传
new CefSettings { MultiThreadedMessageLoop = true }，否则 JS 弹窗、alert、confirm会卡主线程 - 不要设
AnyCPU：项目平台目标必须明确为x64或x86，且与 NuGet 包架构一致（CefSharp.WinForms默认含两套 native dll） - 检查输出目录是否存在
libcef.dll、chrome_elf.dll；若缺失，手动将它们的“复制到输出目录”设为“始终复制” -
Cef.Initialize()返回false？立刻验证LocalesDirPath和ResourcesDirPath指向的locales/和resources/文件夹是否真实存在（默认从app.exe同级找）
ChromiumWebBrowser 加载页面必须用 Load()，不是 Url 属性
ChromiumWebBrowser 的 Url 属性是只读的，直接赋值如 browser.Url = "https://" 完全无效，也不会报错，只会白屏或停留在空白页。
下载 Comet AI 浏览器，体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作，让 AI 成为你的浏览副驾，大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。
- 正确加载方式是调用
browser.Load("https://example.com")或browser.LoadHtml("<h1>Hello</h1>") - 如果页面依赖本地资源（如
test.html），请用绝对路径：browser.Load(new Uri(Path.GetFullPath("test.html")).ToString()) - 动态加载前务必确认
browser.IsBrowserInitialized == true，否则Load()可能被忽略
JS 调 C# 必须等 IsBrowserInitializedChanged 之后再注册对象
RegisterAsyncJsObject 不是“一注册就生效”。在浏览器实例尚未完成初始化时调用，对象会被静默丢弃，JS 端调用 bridge.xxx() 时连 ReferenceError 都不会抛。
- 监听
browser.IsBrowserInitializedChanged += (s, e) => { if (e.IsBrowserInitialized) { /* 此处注册 */ } } - 注册必须用
RegisterAsyncJsObject，RegisterJsObject已弃用，且同步调用会阻塞渲染线程导致卡顿 - 注册对象的方法若需更新 UI（如弹
MessageBox或改控件文本），必须通过SynchronizationContext.Current.Post()或Dispatcher.Invoke()切回 UI 线程 - 别开全局变量陷阱：注册的对象生命周期绑定浏览器实例，窗体关闭前不手动清理，可能引发内存泄漏
C# 调 JS 必须等 FrameLoadEnd 触发后执行
页面 DOM 尚未解析、JS 还没加载完就调用 ExecuteJavaScriptAsync()，代码会静默失败——既不报错，也不执行。
- 监听
browser.FrameLoadEnd += (s, e) => { if (e.Frame.IsMain) { /* 此处执行 JS */ } } - 确保 JS 函数已在全局作用域定义（如
window.myFunc = function(){...}），否则browser.GetMainFrame().EvaluateScriptAsync("myFunc()")会返回null - 避免在
FrameLoadEnd中反复调用同一段 JS：某些脚本（如 Vue 初始化）可能尚未就绪，建议加简单延时或轮询window.myFunc !== undefined
最常被跳过的细节是：CefSharp 的 JS 绑定本质是跨进程通信，所有调用都走异步消息队列。你以为的“立刻执行”，其实卡在了 Chromium 主进程和 .NET UI 线程之间那层看不见的序列化/反序列化里——所以生命周期判断、线程切换、路径校验，一个都不能少。
