简介：面向仍在使用 CEF 嵌入浏览器内核的 C++ 桌面客户端开发者、旧项目维护人员以及需要研究历史版本兼容性的技术团队，这份 Windows 32 位官方二进制包保留了 CEF 3.2357 分支，属于官方已经下架、仍支持 NPAPI 的最高版本，可用于兼容传统浏览器插件、复现旧构建环境、比对不同版本接口差异等场景。压缩包共 580 个文件、约 120.41MB，以 h 头文件和 cc 实现文件为主体，辅以 pak 资源包、dll 动态库、lib 导入库以及 bin、exe 等运行组件，覆盖接口声明、源码封装、资源加载与可执行调试等环节。包内可见 libcef_dll_wrapper 封装层、cef_message_router 消息路由、OSR 离屏渲染窗口和 client_handler 示例，便于读者理解浏览器内核嵌入、进程间消息传递、离屏绘制与客户端事件处理的实现脉络。区别于仅含运行时库的精简包，这份完整发行包保留了头文件、封装源码、资源文件和示例入口，可据此核对接口签名、重建编译链路，并排查资源缺失或库版本不匹配等问题。已有 516 人学习下载，可作为旧版 CEF 工程编译、NPAPI 插件适配与历史问题排查的参考，也为维护老客户端项目提供可追溯的版本备份。
1. 32 位 CEF 3.2357 二进制包：一条被老工程逼出来的退路
某公司还在维护一套 32 位 MFC 上位机，客户机器是 Win7 甚至更老的系统，现在要在界面里嵌一块网页显示报表和图表。换 Electron 等于放弃 32 位和老系统，换新内核的 WebView 又上不了那些机器，最后翻出来的往往是cef_binary_3.2357.1271.g8e0674e_windows32这个包：CEF3 分支号 2357（对应 Chromium 43），Win32 官方二进制产物，带 libcef.dll、完整头文件、libcef_dll 包装层源码和 cefclient 示例。它解决的是「老工具链、老系统、32 位单机软件里塞一个还算现代的渲染内核」，适合 VS2010/2013 编译、要交付 32 位 exe 的 C++ 团队。先给个反直觉结论：这个分支里 npapi 已经没了，冲着老插件来的人一定会失望。
2. 拆包看目录：Release 与 Debug 两套 DLL 怎么摆进 C++ 工程
拿到 zip 的第一件事不是打开 VS，而是把目录结构和三个版本号对一遍。这个包里最容易出事的地方，全在「文件放没放对」和「wrapper 有没有配对」上，代码反而排在后面。
2.1 包里到底有什么，哪些是运行必需
解压后大致是这样几块：include/放全部 CEF 头文件，libcef_dll/是官方包装层源码（cef_client、cef_v8handler 这些派生类的实现），tests/是 cefclient / cefsimple 的完整示例工程，cmake/、tools/、CMakeLists.txt负责生成工程文件，Release/和Debug/各放一套已经编好的二进制。
先看include/cef_version.h，里面两个宏决定了一切后续动作：CEF_VERSION是3.2357.1271.g8e0674e，CEF_CHROME_VERSION是它底层 Chromium 的版本。这两个字符串必须和Release/libcef.dll是同一批产物，混用任何一个别的分支的头文件或包装层，编译能过、跑起来就是内存越界。
运行时文件的取舍，我一般按这张表来分：
| 文件 | 是否必需 | 作用与缺失后果 |
|---|---|---|
| libcef.dll | 必需 | 内核本体，缺了直接启动失败 |
| libcef.lib | 必需（链接期） | 导入库，注意它只是导入库，不是静态库 |
| cef.pak | 必需 | 基础资源，缺了界面全白 |
| cef_100_percent.pak / cef_200_percent.pak | 必需 | 不同 DPI 下的图标位图 |
| cef_extensions.pak | 建议 | 扩展相关资源，用 V8 扩展就要带 |
| devtools_resources.pak | 调试必需 | 不带就打不开 DevTools |
| icudtl.dat | 必需 | ICU 数据，缺了初始化阶段就崩 |
| natives_blob.bin / snapshot_blob.bin | 必需 | V8 快照，缺了启动变慢甚至报错 |
| locales/*.pak | 至少 en-US.pak | 中文要 zh-CN.pak，整目录抄最省事 |
| d3dcompiler_47.dll | 建议 | GPU 合成用，缺了退回软件渲染 |
| libEGL.dll / libGLESv2.dll | 建议 | ANGLE 相关，带 WebGL 时必须 |
| ffmpegsumo.dll | 看需求 | 音视频解码，不播媒体可不带 |
Release/和Debug/里的cefclient.exe、cefsimple.exe千万别删，它们是后面排错时唯一的参照物。目录里如果还带了cef_sandbox.lib，说明这个分支支持沙箱，但 32 位 + 老系统上我一般先用no_sandbox跑通，再回来评估。
2.2 静态链接在这个包上不成立
新手最常见的误判，是以为libcef.lib是静态库，想把它整个链进 exe 做成单文件。它不是——它只是libcef.dll的导入库，官方二进制分发包只提供动态链接这一条路。真要静态链接，得自己拉源码用 GN/CMake 全量编译，那是另一个量级的工作，而且 32 位下体积和地址空间都很难看。
所以工程里必须接受一个事实：交付目录里永远躺着一个几十 MB 的libcef.dll，以及一堆 .pak 和 .bin。用安装包打包时把这些文件作为独立项列进去，别指望合并。
另一件容易被忽略的事：libcef_dll/里的包装层源码必须自己编成libcef_dll_wrapper.lib。它和你的工程必须用同一套 CRT 设置（/MD配/MD，/MDd配/MDd）、同一个平台（Win32）、同一个配置（Debug 对 Debug）。CMake 生成的工程默认是/MD，如果你的 MFC 工程是/MT，链接阶段不一定报错，运行到字符串转换那一步就崩，这种问题查起来能耗掉一整天。
2.3 把运行时文件抄进输出目录的一次性脚本
与其每次手工拖文件，不如写一个拷贝脚本挂在生成后事件里。以 Release、输出到..\bin\Win32\Release为例：
@echo off set CEF=cef_binary_3.2357.1271.g8e0674e_windows32\Release set OUT=..\bin\Win32\Release copy /Y "%CEF%\libcef.dll" "%OUT%" copy /Y "%CEF%\cef.pak" "%OUT%" copy /Y "%CEF%\cef_100_percent.pak" "%OUT%" copy /Y "%CEF%\cef_200_percent.pak" "%OUT%" copy /Y "%CEF%\cef_extensions.pak" "%OUT%" copy /Y "%CEF%\devtools_resources.pak" "%OUT%" copy /Y "%CEF%\icudtl.dat" "%OUT%" copy /Y "%CEF%\natives_blob.bin" "%OUT%" copy /Y "%CEF%\snapshot_blob.bin" "%OUT%" copy /Y "%CEF%\d3dcompiler_47.dll" "%OUT%" copy /Y "%CEF%\libEGL.dll" "%OUT%" copy /Y "%CEF%\libGLESv2.dll" "%OUT%" if exist "%CEF%\ffmpegsumo.dll" copy /Y "%CEF%\ffmpegsumo.dll" "%OUT%" xcopy "%CEF%\locales" "%OUT%\locales" /E /I /Y脚本里的if exist是刻意的：不同小版本的二进制包内容略有出入，写死文件名会在别人机器上直接断掉构建。locales用xcopy /E整目录抄，别图省空间只留 en-US，中文环境下少了 zh-CN.pak，界面文案会退回英文，看起来像「内核没加载成功」，实际只是资源没带。
Debug 配置同理，把CEF换成Debug目录即可，但两套文件绝不能混放——Debug 版libcef.dll依赖调试版 CRT，和 Release 的 exe 放一起会在加载阶段就失败。
3. 最小可运行 CEF 程序：CefInitialize 到 CefShutdown 的完整顺序
跑通一个空白页，比读十页文档有用。这一章按执行顺序拆：进程分支判断、CefSettings 里必须动的参数、把浏览器塞进已有 HWND、以及退出时谁先谁后。
3.1 进程分支：CefExecuteProcess 必须放在最前面
CEF3 是多进程模型：你的 exe 会被自己反复拉起，分别充当 browser 进程、render 进程、GPU 进程和 utility 进程。区分它们只靠一个入口函数——CefExecuteProcess。它在子进程里会阻塞到该进程结束并返回非负值，在 browser 进程里立刻返回 -1。
// main.cpp：顺序不能动，这是整个嵌入的地基 #include "include/cef_app.h" #include "include/cef_browser.h" int APIENTRY wWinMain(HINSTANCE hInstance, HINSTANCE, LPWSTR, int) { CefMainArgs main_args(hInstance); // 32 位下就是模块句柄 CefRefPtr<ClientApp> app(new ClientApp()); // 自己实现的 CefApp // 子进程会停在这里直到结束；只有 browser 进程返回 -1 int exit_code = CefExecuteProcess(main_args, app.get(), nullptr); if (exit_code >= 0) return exit_code; CefSettings settings; // 具体参数见 3.2 if (!CefInitialize(main_args, settings, app.get(), nullptr)) { return 1; // 初始化失败，去看日志文件 } CefRunMessageLoop(); // 单线程消息循环模式 CefShutdown(); return 0; }三个参数值得说明：main_args在 Windows 上就是HINSTANCE，别传命令行字符串；app传裸指针，CEF 内部会自己 AddRef；最后一个参数是沙箱信息结构指针，不用沙箱就传nullptr。
这里最常见的翻车方式是把它塞进 MFC 的InitInstance里，前面已经做了一堆 UI 初始化。结果每个 render 子进程都会把主窗口、托盘图标、定时器全建一遍，任务管理器里能看到几个同名进程同时弹窗。血泪经验：CefExecuteProcess放在wWinMain或InitInstance的第一行，前面只允许有局部变量声明。
3.2 CefSettings 里必须动的几个参数
CefSettings字段很多，真正影响能不能跑起来的是这几个：
| 参数 | 建议值 | 为什么 |
|---|---|---|
single_process | false | 设 true 只是调试方便，一崩全崩，且行为与多进程不一致 |
no_sandbox | true（先） | 32 位老系统上先关沙箱跑通，上线前再评估 |
browser_subprocess_path | 留空或指定 helper.exe | 主 exe 改名/被壳程序包裹时必须显式指定 |
locale | "zh-CN" | 必须和 locales 目录里的 pak 对应 |
log_severity | LOGSEVERITY_INFO | 默认只记 WARNING 以上，排错时看不到东西 |
multi_threaded_message_loop | MFC 里常设 true | 让 CEF 自己跑 UI 线程，避免和 MFC 消息泵打架 |
windowless_rendering_enabled | 需要离屏渲染才开 | 开了之后不再创建子 HWND，回调全走 OSR |
remote_debugging_port | 排障期开一个 | 见最后一章 |
写成代码大概是这样：
CefSettings settings; settings.single_process = false; settings.no_sandbox = true; settings.multi_threaded_message_loop = false; // 用 CefRunMessageLoop 就必须是 false settings.log_severity = LOGSEVERITY_INFO; settings.log_file = L"cef_debug.log"; CefString(&settings.locale).FromASCII("zh-CN"); CefString(&settings.cache_path).FromASCII("cache"); // 相对路径相对 exe 所在目录 CefString(&settings.product_version).FromASCII("1.0.0"); // 用户代理按需伪装，很多老服务端会按 UA 分支输出 // CefString(&settings.user_agent).FromASCII("Mozilla/5.0 ...");multi_threaded_message_loop和CefRunMessageLoop是互斥的：设了 true 就不能再调CefRunMessageLoop，也不能调CefDoMessageLoopWork，否则消息会被两个线程抢。MFC 工程里我更倾向设 true，让 MFC 自己的Run()继续负责主消息泵；纯 Win32 或控制台程序就用默认 false 加CefRunMessageLoop。
3.3 用 CreateBrowserSync 把浏览器嵌进已有 HWND
嵌到已有窗口上，用子窗口模式最省事：CEF 会在你给的父窗口里创建一个填满指定矩形的子 HWND，滚动、焦点、右键菜单都由它自己处理。
#include "include/cef_client.h" // 最小客户端：只接管生命周期 class SimpleHandler : public CefClient, public CefLifeSpanHandler { public: CefRefPtr<CefBrowser> browser_; CefRefPtr<CefLifeSpanHandler> GetLifeSpanHandler() override { return this; } void OnAfterCreated(CefRefPtr<CefBrowser> browser) override { CefLifeSpanHandler::OnAfterCreated(browser); browser_ = browser; // 拿到句柄，后面关闭、执行 JS 都靠它 } void OnBeforeClose(CefRefPtr<CefBrowser> browser) override { browser_ = nullptr; ::PostQuitMessage(0); // 浏览器真正销毁了，才通知消息循环退出 } IMPLEMENT_REFCOUNTING(SimpleHandler); }; void EmbedBrowser(HWND hParent, const CefString& url) { RECT rc; ::GetClientRect(hParent, &rc); CefWindowInfo info; info.SetAsChild(hParent, rc); // 子窗口模式，自动填满 rc CefBrowserSettings bsettings; bsettings.javascript = STATE_ENABLED; bsettings.plugins = STATE_ENABLED; // 要跑 PPAPI 插件就得开 bsettings.webgl = STATE_DISABLED; // 老显卡驱动上先关，少一类崩溃 CefRefPtr<SimpleHandler> client(new SimpleHandler()); // 部分 2357 小版本的 CreateBrowserSync 只有 4 个参数， // 编译报「参数过多」就把最后那个 nullptr 去掉 CefBrowserHost::CreateBrowserSync(info, client.get(), url, bsettings, nullptr); }SetAsChild内部会把窗口样式设成WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN | WS_CLIPSIBLINGS，所以父窗口自己最好也带WS_CLIPCHILDREN，否则重绘时会闪。父窗口尺寸变化时不需要你手动 Resize，CEF 会跟着父窗口走；但如果你是把它贴在某个 Tab 页里，切换 Tab 时记得ShowWindow子窗口，不然会出现白块。
CreateBrowserSync是同步的，会阻塞到页面框架创建完成，启动阶段调用没问题；如果要开多个页面，第二个开始用CreateBrowser（异步）更合适。
3.4 退出顺序：谁先谁后决定会不会卡死
关闭流程是这个组件最容易写错的地方，因为它不是「点关闭就退」。正确链路是：调用CloseBrowser→ CEF 异步销毁浏览器 →OnBeforeClose回调 → 你在这里PostQuitMessage→ 消息循环结束 →CefShutdown。
// 主窗口过程里，用户点右上角关闭 case WM_CLOSE: if (handler->browser_) { // 参数 true 表示强制关闭，不触发页面 onbeforeunload handler->browser_->GetHost()->CloseBrowser(true); } return 0; // 不要在这里 DestroyWindow 或 PostQuitMessageCloseBrowser(true)和CloseBrowser(false)的区别在于是否给页面onbeforeunload一次拦截机会。业务系统里如果有未保存表单，用 false，并在CefLifeSpanHandler::DoClose里配合处理；内部的工具页用 true 省事。
两个禁忌：不要在WM_CLOSE里直接CefShutdown()，那时浏览器还没销毁，必然崩在析构里；也不要在OnBeforeClose之后再调CefRunMessageLoop，循环已经退出了。如果进程退出后任务管理器里还剩几个同名进程，八成是某条分支上漏了CefShutdown。
4. NPAPI 已死之后：这个分支里插件与原生能力的三条替代路线
搜cef npapi c++ 2357这组词的人，心里想的通常是「我有个老插件要在内嵌浏览器里跑」。先把结论摆出来：这条路在 2357 上走不通，但替代方案有三条，选对了并不影响交付。
4.1 Chromium 43 的插件边界：npapi 为什么加载不了
Chromium 在 42 版本就把 NPAPI 移除了，2357 是 43 分支，底层根本没有加载 NPAPI 插件的代码路径。CEF 的头文件里也找不到任何CefRegisterPlugin之类给 NPAPI 用的接口——那套东西属于 CEF1 时代。
所以要先分清手上的工程到底是 CEF1 还是 CEF3。判断方法很简单：看include/cef_version.h里CEF_VERSION首段是 1 还是 3。两者不是版本高低的关系，是两套完全不同的架构：
| 能力 | CEF1 | CEF3（2357） |
|---|---|---|
| NPAPI 插件 | 支持 | 不支持 |
| PPAPI（Flash 等） | 不支持 | 支持，走命令行加载 |
| 多进程模型 | 否，单进程 | 是，browser/render/gpu 分离 |
| 离屏渲染 OSR | 否 | 支持 |
| 分支维护状态 | 早已停止 | 该分支已归档 |
| 崩溃影响面 | 整进程 | 通常只挂一个 render 进程 |
如果你手上的老控件只有 NPAPI 版本，实际可选项就三个：找厂商要 PPAPI 版本（大概率没有）；把控件能力拆成 C++ 侧接口，通过 V8 扩展暴露给页面；或者干脆保留一个 ActiveX 容器窗口，用原生窗口叠加的方式和 CEF 子窗口并存。最后一种在工业上位机里很常见，代价是两套渲染叠在一起，窗口层级和焦点会有点难受。
4.2 PPAPI 与 pepflashplayer 的加载参数
如果只是要跑 Flash 类内容，2357 还留着口子：把 32 位的pepflashplayer.dll放到 exe 目录，然后在OnBeforeCommandLineProcessing里追加两个开关。
void ClientApp::OnBeforeCommandLineProcessing( const CefString& process_type, CefRefPtr<CefCommandLine> command_line) { // 只对 browser 进程生效，子进程不用重复加 if (!process_type.empty()) return; command_line->AppendSwitchWithValue( "ppapi-flash-path", L"C:\\app\\pepflashplayer.dll"); // 必须是绝对路径 command_line->AppendSwitchWithValue("ppapi-flash-version", "32.0.0.371"); command_line->AppendSwitch("allow-outdated-plugins"); command_line->AppendSwitch("disable-gpu"); // 虚拟机里先关 GPU 更省事 }参数说明：ppapi-flash-path用绝对路径，相对路径在子进程里解析基准不一样，会加载不到；ppapi-flash-version版本号要和 dll 实际版本一致，写错会被判定为过期插件直接拒载；allow-outdated-plugins是为了绕过过期检查。32 位 CEF 必须配 32 位插件 dll，这一条每年都有人栽。
另外记得把CefBrowserSettings.plugins设成STATE_ENABLED，默认是禁用的，只在命令行加开关不生效。
4.3 用 V8 扩展加 CefV8Handler 暴露 C++ 能力
NPAPI 的本质是「让页面调原生代码」，这件事在 CEF3 里有更干净的替代：注册一个 V8 扩展，页面里就能直接调到你的 C++ 函数。
// 1) C++ 侧：处理页面传来的调用 class NativeBridge : public CefV8Handler { public: bool Execute(const CefString& name, CefRefPtr<CefV8Value> object, const CefV8ValueList& arguments, CefRefPtr<CefV8Value>& retval, CefString& exception) override { if (name == "getMachineCode") { retval = CefV8Value::CreateString(ReadMachineCode()); // 自己的实现 return true; } if (name == "writeLog") { if (arguments.size() != 1 || !arguments[0]->IsString()) { exception = "writeLog 需要 1 个字符串参数"; return true; // 返回 true 表示已处理，异常会抛回 JS } OutputDebugStringA(arguments[0]->GetStringValue().ToString().c_str()); retval = CefV8Value::Create <p> <a href="https://download.csdn.net/download/xinyulou/12787057" style="color:#ec7500;font-size:14px;"> 本文还有配套的精品资源，点击获取 </a> <img alt="menu-r.4af5f7ec.gif" src="https://csdnimg.cn/release/wenkucmsfe/public/img/menu-r.4af5f7ec.gif" style="width:16px;margin-left:4px;vertical-align:text-bottom;cursor:text;"> </p>
