cef_simple是最快上手CEF的起点，已预配CMake、链接顺序、资源路径和消息循环；cef_initialize()须在UI线程早于窗口创建调用，multi_threaded_message_loop=false最稳；CefApp派生类必须全局唯一；Resources/和locales/需与exe同级；窗口嵌入需传有效HWND并设置WS_CLIPCHILDREN|WS_CLIPSIBLINGS，及时处理WM_SIZE；JS与C++通信需在渲染进程注册V8对象并通过进程间消息交互；Release崩溃多因/MT与/MD混用，须统一运行时库。
cef_simple 项目是最快上手的起点
直接编译运行官方 cef_simple 示例，比从零搭工程快得多。它已经配好 CMake、链接顺序、资源路径和消息循环集成，跳过这步容易卡在 CEF Initialize failed 或白屏。
关键点：
-
cef_initialize()必须在主线程（UI 线程）调用，且早于任何窗口创建；传入的CefSettings中multi_threaded_message_loop = false是 Windows 下最稳的配置 -
CefApp派生类必须全局唯一实例，不能局部构造或多次 new；否则OnContextInitialized可能不触发 - 资源目录（
Resources/和locales/）必须与可执行文件同级，路径不对会静默失败，控制台无报错但页面空白
窗口嵌入要用 CefBrowserHost::CreateBrowser 传 HWND
CEF 不自己创建窗口，而是把渲染内容挂到已有 HWND 上。你得先用 Win32 API（或 Qt/WxWidgets）建一个普通窗口，再把它的句柄传给 CEF。
常见错误：
立即学习“C++免费学习笔记（深入）”；
- 传入 NULL 或无效 HWND → 浏览器不显示，
OnAfterCreated不回调 - 窗口未启用 WS_CLIPCHILDREN | WS_CLIPSIBLINGS → 页面闪烁、控件重叠、输入框失焦
- 未处理 WM_SIZE 并调用
browser->GetHost()->WasResized()→ 窗口缩放后内容拉伸或裁剪
示例片段：
CefWindowInfo window_info; window_info.SetAsChild(hwnd, CefRect(0, 0, width, height)); CefRefPtr<CefClient> client = new MyClient(); CefBrowserHost::CreateBrowser(window_info, client, url, settings, nullptr);
JS 与 C++ 通信靠 CefV8Handler 和 CefRenderProcessHandler
想让网页 JS 调 C++ 函数，不是绑个全局对象就行——必须在渲染进程（Render Process）中注册 V8 对象，主进程（Browser Process）收不到 JS 调用。
典型结构：
- 主进程实现
CefClient，返回自定义CefRenderProcessHandler - 渲染进程中重写
OnWebKitInitialized()，获取全局上下文，注入CefV8Value对象 - JS 调用该对象方法时，
CefV8Handler::Execute()在渲染进程被触发，如需回传数据给主进程，走CefProcessMessageRef异步发消息
坑点：
- 渲染进程默认沙箱开启，无法直接访问文件系统或调用 Win32 API；敏感操作必须通过进程间消息委托给主进程
-
CefV8Value::SetAccessor()注册的 getter/setter 不支持跨帧访问，iframe 里拿不到父页挂的 JS 对象
Release 模式下崩溃大概率是运行时库或符号不匹配
CEF 官方预编译二进制只支持静态链接 /MT（Windows），若你的工程用 /MD，必然在 CefInitialize 或加载第一个页面时崩溃，堆栈停在 ntdll.dll 或 vcruntime140.dll。
解决方式只有两个：
- 整个解决方案统一设为
/MT（含所有依赖库），并确保 CEF 的libcef_dll_wrapper也是 /MT 编译 - 改用 CEF 的「General Distribution」源码自行用 /MD 编译，但构建耗时 4+ 小时，且要同步 Chromium 版本更新
另外：Debug 下能跑不代表 Release 安全。Release 会内联、优化掉某些检查逻辑，比如忘记调 CefShutdown() 在 Debug 可能没事，Release 下可能引发内存释放后使用（use-after-free）。
真正麻烦的从来不是“怎么嵌”，而是“怎么不让它在客户机器上崩”。路径、线程、进程模型、运行时、符号表——漏掉任一环，都是黑屏、假死或偶发崩溃。
