企业官网建设流程全解析

1. 项目缘起与整体设计思路

1.1 为什么会有“自己写一个浏览器”这个念头

很多人第一次听到“用 VC++ 调用浏览器内核做一个简易浏览器”这个想法时，第一反应是：现在浏览器这么多，为什么还要自己造轮子？其实这个问题的答案跟“为什么有人要自己组装电脑”是一样的——不是为了替代品牌机，而是为了搞清楚里面到底是怎么跑起来的。对于做 Windows 桌面开发的人来说，浏览器控件是一个极其常见的需求：你做了一个本地帮助系统，想用 HTML 来排版；你做了一个数据看板，想用网页技术来渲染图表；你做了一个自动化工具，需要加载某个页面并抓取内容。这些场景下，你不需要一个完整的 Chrome，你只需要一个能解析 HTML、执行 JavaScript、渲染页面的“最小内核”。

标题里说的“最小的浏览器内核”，在 Windows 平台上通常指的就是系统自带的WebBrowser 控件，也就是基于 IE 的 Trident 引擎。为什么说它“最小”？因为它不需要你额外安装任何运行时，不需要打包几百兆的 Chromium，不需要处理复杂的进程模型。你只需要在 VC++ 的对话框上拖一个控件，写几行代码，一个能加载网页的窗口就出来了。这对于快速验证想法、做内部工具、给老系统加一个网页展示能力来说，性价比极高。

当然，有人会问：现在都什么年代了，还用 IE 内核？这里需要澄清一个概念：WebBrowser 控件虽然底层是 Trident，但通过设置FEATURE_BROWSER_EMULATION注册表项，可以让它模拟从 IE7 到 IE11 的不同文档模式。对于很多内部系统、老式网页、简单的 HTML+CSS 页面来说，IE11 模式已经足够用了。而且它的优势在于“零依赖”——你的程序拿到任何一台 Windows 机器上都能跑，不需要用户装这个装那个。这就是“最小”的真正含义：不是功能最弱，而是依赖最少、集成成本最低。

1.2 整体方案选型：为什么是 WebBrowser 控件而不是其他方案

在 Windows 上用 C++ 做浏览器相关的开发，大致有这么几条路：一是直接用 WebBrowser 控件（IE 内核）；二是嵌入 Chromium Embedded Framework（CEF）；三是用 WebView2（Edge 内核）；四是自己解析 HTML 然后自己画。这四条路各有各的适用场景，我简单说一下我的选择逻辑。

CEF 功能最强，但编译一次要几个小时，运行时要带上几百兆的 DLL 和资源文件，部署起来很重。WebView2 是微软现在主推的方案，基于 Edge 内核，功能新、性能好，但它要求目标机器上安装了 Edge WebView2 Runtime，虽然现在 Win10/Win11 基本都自带了，但在一些老旧的工业控制机上不一定有。自己解析 HTML 那就更不用说了，除非你是为了学习编译原理，否则完全不现实。

WebBrowser 控件的优势在于：它是 Windows 系统自带的 COM 组件，不需要任何额外的运行时。你只需要在 VC++ 里通过AfxEnableControlContainer()启用控件容器，然后插入一个Microsoft Web Browser控件，就能得到一个完整的浏览器窗口。它支持 HTML4、CSS2、部分 CSS3、JavaScript 1.5，对于展示型页面、简单交互页面完全够用。而且它暴露了完整的 COM 接口，你可以通过IWebBrowser2接口控制导航、前进后退、刷新、获取当前 URL、注入脚本等等。对于“简易浏览器”这个目标来说，它是成本最低、见效最快的方案。

我最终选择的开发环境是 Visual Studio 2019 + MFC。为什么用 MFC 而不是纯 Win32？因为 MFC 对 COM 控件的封装更友好，对话框编辑器里可以直接拖控件，省去了大量手写CreateWindow和OleCreate的代码。当然，如果你对 Win32 API 更熟悉，用纯 Win32 也能做，只是代码量会大一些。下面的内容我会以 MFC 为主线来展开，但在关键的地方会说明纯 Win32 下应该怎么处理。

1.3 最终成品应该长什么样

在动手之前，先想清楚目标。一个“简易浏览器”至少应该具备这些功能：一个地址栏，输入 URL 后按回车能加载页面；一个显示区域，能渲染网页内容；前进、后退、刷新、停止这四个基本按钮；一个状态栏，显示当前加载状态或鼠标悬停的链接地址。这些功能不需要多漂亮，但必须能用。

再进一步，可以加上：主页按钮、收藏夹（用本地文件存 URL 列表）、在新窗口打开链接、查看页面源码、缩放页面。这些属于锦上添花，第一版可以先不做。我的建议是第一版只做核心功能，跑通之后再逐步加。因为 WebBrowser 控件的很多行为跟现代浏览器不一样，你需要花时间去踩坑，一开始就铺太大容易卡住。

2. 核心细节解析与实操要点

2.1 WebBrowser 控件的本质与 COM 接口体系

WebBrowser 控件本质上是一个 ActiveX 控件，它的底层是SHDOCVW.dll里实现的WebBrowser对象。这个对象实现了IWebBrowser2接口，而IWebBrowser2继承自IWebBrowserApp，后者又继承自IWebBrowser。这一串接口提供了导航、刷新、停止、获取文档对象等能力。但光有IWebBrowser2还不够，你还需要跟文档内容交互，这就需要用到IHTMLDocument2、IHTMLWindow2等接口。

在 MFC 里，当你把一个 WebBrowser 控件拖到对话框上时，IDE 会自动为你生成一个包装类，通常叫CWebBrowser2或者类似的名称。这个类封装了IWebBrowser2的大部分方法，比如Navigate()、GoBack()、GoForward()、Refresh()、Stop()。但要注意，这个包装类只是薄薄一层，很多高级功能（比如注入 JavaScript、获取页面标题、监听加载完成事件）需要你自己去查询底层接口。

这里有一个关键点：WebBrowser 控件的所有操作都必须在 UI 线程上执行，而且很多接口调用是异步的。比如你调用Navigate()之后，它不会立刻返回加载结果，而是通过事件通知你。MFC 的包装类提供了一些事件映射宏，比如BeforeNavigate2、DocumentComplete、NavigateComplete2、StatusTextChange、TitleChange等。你需要在自己的对话框类里添加这些事件的处理函数，才能实现地址栏同步、状态栏更新、加载进度显示等功能。

2.2 初始化与控件创建的注意事项

在 MFC 对话框程序里使用 WebBrowser 控件，第一步是在InitInstance()里调用AfxEnableControlContainer()。这个函数的作用是初始化 OLE 控件容器，没有它，控件根本创建不出来。很多新手会忘记这一步，然后发现对话框上放了一个空白区域，什么也不显示，调试半天找不到原因。

第二步是在对话框的OnInitDialog()里创建控件。如果你是用资源编辑器拖的控件，那么控件会在DoDataExchange()里通过DDX_Control绑定到一个成员变量上。但这里有一个坑：WebBrowser 控件在对话框创建时可能还没有完全初始化，你需要确保在OnInitDialog()返回之前不要调用任何导航方法。更稳妥的做法是在OnInitDialog()里先调用基类的OnInitDialog()，然后再做自己的初始化。

还有一个非常重要的设置：浏览器仿真模式。默认情况下，WebBrowser 控件会以 IE7 的文档模式渲染页面，这会导致很多现代网页显示错乱。你需要通过修改注册表来告诉它使用更高的文档模式。具体做法是在HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION下添加一个以你的可执行文件名命名的 DWORD 值，设置为11001（IE11 边缘模式）或11000（IE11 标准模式）。这个操作必须在程序启动时、创建控件之前完成，否则不生效。

// 设置浏览器仿真模式为 IE11 void SetBrowserEmulation() { TCHAR exePath[MAX_PATH]; GetModuleFileName(NULL, exePath, MAX_PATH); TCHAR* exeName = _tcsrchr(exePath, _T('\\')); if (exeName) exeName++; else exeName = exePath; HKEY hKey; if (RegCreateKeyEx(HKEY_CURRENT_USER, _T("Software\\Microsoft\\Internet Explorer\\Main\\FeatureControl\\FEATURE_BROWSER_EMULATION"), 0, NULL, REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &hKey, NULL) == ERROR_SUCCESS) { DWORD dwMode = 11001; RegSetValueEx(hKey, exeName, 0, REG_DWORD, (const BYTE*)&dwMode, sizeof(dwMode)); RegCloseKey(hKey); } }

注意：这个注册表写入操作只需要做一次，但每次程序启动时都写一遍也无妨，因为它是幂等的。如果你不想污染注册表，也可以在安装程序里做这一步，或者只在调试时手动改。

2.3 导航、前进后退与地址栏同步

导航的核心方法是Navigate()，它的签名在 MFC 包装类里通常是Navigate(LPCTSTR URL, VARIANT* Flags, VARIANT* TargetFrameName, VARIANT* PostData, VARIANT* Headers)。对于简单的 GET 请求，后面四个参数都可以传NULL。但要注意，Navigate()接受的 URL 必须是完整的，比如https://www.example.com，如果你只输入www.example.com，它可能无法识别。所以地址栏的处理逻辑里，需要自动补全协议头。

前进后退的实现很简单，直接调用GoBack()和GoForward()。但你需要根据当前是否可前进/可后退来启用或禁用按钮，这可以通过IWebBrowser2::get_ReadyState()和get_LocationURL()来判断，但更简单的方式是在CommandStateChange事件里处理。这个事件会告诉你哪些命令当前可用，你根据Command参数（CSC_NAVIGATEBACK或CSC_NAVIGATEFORWARD）来设置按钮的EnableWindow状态。

地址栏同步的难点在于：用户可能在页面里点击链接跳转，这时候地址栏需要自动更新。这就要用到NavigateComplete2事件，在这个事件里通过get_LocationURL()获取当前 URL，然后设置到地址栏的编辑框里。但要注意，NavigateComplete2触发时页面可能还没有完全加载完，不过 URL 已经是最终的了，所以用来更新地址栏是合适的。

2.4 状态栏与加载状态反馈

状态栏的作用是给用户反馈。WebBrowser 控件提供了StatusTextChange事件，当鼠标悬停在链接上时，控件会触发这个事件，参数里包含链接的 URL 或描述文字。你可以把这个文字显示在状态栏上。另外，ProgressChange事件可以告诉你加载进度，但 IE 内核的进度报告不太准确，很多时候直接跳到 100%，所以我的建议是不要做进度条，只在状态栏显示“正在加载...”和“完成”两种状态就够了。

判断页面是否加载完成，最可靠的信号是DocumentComplete事件。这个事件触发时，页面的 DOM 已经构建完毕，可以安全地执行脚本注入了。但要注意，如果一个页面包含多个框架（iframe），DocumentComplete可能会触发多次。你需要判断pDisp参数是否等于顶层浏览器的IDispatch，只有相等时才表示整个页面加载完成。

3. 实操过程与核心环节实现

3.1 创建 MFC 对话框工程与控件绑定

打开 Visual Studio，新建一个 MFC 应用程序，选择“基于对话框”的类型。在资源视图里打开主对话框，右键选择“插入 ActiveX 控件”，找到“Microsoft Web Browser”并确定。调整控件大小，给它分配一个 ID，比如IDC_EXPLORER1。然后右键控件，选择“添加变量”，变量类型选择CWebBrowser2（如果列表里没有，说明你的 VS 没有安装 MFC 的 ActiveX 支持，需要重新运行安装程序勾选“MFC”和“ActiveX”相关组件）。

绑定完成后，在对话框类的头文件里会多出一个成员变量，比如m_browser。在DoDataExchange()里会看到DDX_Control(pDX, IDC_EXPLORER1, m_browser)。这时候编译运行，你应该能看到一个空白的浏览器区域。如果显示的是一个带斜线的圆圈或者空白，说明控件没有正确初始化，检查AfxEnableControlContainer()是否调用了。

接下来添加地址栏和按钮。地址栏用一个CEdit控件，ID 设为IDC_EDIT_URL。前进、后退、刷新、停止、转到这几个按钮分别设置 ID。然后在对话框类里添加对应的成员变量和事件处理函数。地址栏的编辑框可以绑定一个CString变量，方便读写。

3.2 实现导航功能与地址栏回车响应

地址栏回车的处理，需要重写对话框的PreTranslateMessage()函数，或者在编辑框的EN_CHANGE里做文章。更简单的做法是给编辑框添加一个OnKeyDown处理函数，判断VK_RETURN。但 MFC 的对话框默认会把回车键当作“默认按钮”的点击，所以你需要重写OnOK()函数，在里面判断焦点是否在地址栏上。

void CMyBrowserDlg::OnOK() { if (GetFocus() == &m_editUrl) { CString strUrl; m_editUrl.GetWindowText(strUrl); NavigateToUrl(strUrl); return; } CDialogEx::OnOK(); } void CMyBrowserDlg::NavigateToUrl(const CString& strUrl) { CString url = strUrl; url.Trim(); if (url.IsEmpty()) return; // 自动补全协议头 if (url.Left(7) != _T("http://") && url.Left(8) != _T("https://") && url.Left(6) != _T("ftp://") && url.Left(7) != _T("file://")) { if (url.Find(_T('.')) > 0 && url.Find(_T(' ')) < 0) url = _T("https://") + url; else url = _T("https://www.bing.com/search?q=") + url; } m_browser.Navigate(url, NULL, NULL, NULL, NULL); }

这段代码里有一个小技巧：如果用户输入的内容包含点号且没有空格，就当作域名处理，自动加https://；否则当作搜索词，跳转到搜索引擎。这个逻辑跟现代浏览器的地址栏行为是一致的，用户体验会好很多。

3.3 事件处理：DocumentComplete 与 StatusTextChange

在对话框类的头文件里，找到事件映射区域，添加DocumentComplete和StatusTextChange的映射。然后在实现文件里写处理函数。

BEGIN_EVENTSINK_MAP(CMyBrowserDlg, CDialogEx) ON_EVENT(CMyBrowserDlg, IDC_EXPLORER1, 259, OnDocumentComplete, VTS_DISPATCH VTS_PVARIANT) ON_EVENT(CMyBrowserDlg, IDC_EXPLORER1, 102, OnStatusTextChange, VTS_BSTR) END_EVENTSINK_MAP() void CMyBrowserDlg::OnDocumentComplete(LPDISPATCH pDisp, VARIANT* URL) { // 判断是否是顶层框架 IDispatch* pTopDisp = NULL; m_browser.get_Application(&pTopDisp); // 这里需要查询底层接口 // 简化处理：直接更新地址栏 CString strUrl = m_browser.get_LocationURL(); m_editUrl.SetWindowText(strUrl); SetWindowText(_T("简易浏览器 - ") + strUrl); } void CMyBrowserDlg::OnStatusTextChange(LPCTSTR lpszText) { m_statusBar.SetWindowText(lpszText); }

这里要注意，MFC 的CWebBrowser2包装类可能没有直接暴露get_LocationURL()方法，你需要通过QueryInterface获取IWebBrowser2指针，然后调用get_LocationURL()。或者更简单的方式是使用m_browser.get_LocationURL()，如果编译报错，就说明包装类没有这个方法，需要自己封装。

3.4 注入 JavaScript 与获取页面内容

有时候你需要在页面加载完成后执行一些自定义脚本，比如隐藏某个广告栏、自动填充表单、提取数据。这需要用到IHTMLDocument2接口。获取文档对象的步骤如下：先通过m_browser.get_Document()得到一个IDispatch指针，然后QueryInterface到IHTMLDocument2，再通过get_Script()得到IHTMLWindow2，最后调用execScript()执行脚本。

void CMyBrowserDlg::ExecuteScript(const CString& script) { LPDISPATCH pDisp = m_browser.get_Document(); if (!pDisp) return; IHTMLDocument2* pDoc = NULL; if (SUCCEEDED(pDisp->QueryInterface(IID_IHTMLDocument2, (void**)&pDoc))) { IHTMLWindow2* pWindow = NULL; if (SUCCEEDED(pDoc->get_parentWindow(&pWindow))) { BSTR bstrScript = script.AllocSysString(); VARIANT vResult; VariantInit(&vResult); pWindow->execScript(bstrScript, L"JavaScript", &vResult); SysFreeString(bstrScript); pWindow->Release(); } pDoc->Release(); } pDisp->Release(); }

这个功能非常实用。比如你可以在DocumentComplete里调用ExecuteScript(_T("document.body.style.zoom='150%'"))来实现页面缩放。或者调用ExecuteScript(_T("document.getElementById('ad').style.display='none'"))来隐藏特定元素。

3.5 处理新窗口打开与弹窗拦截

WebBrowser 控件默认会在新窗口打开target="_blank"的链接，这会导致弹出一个新的 IE 窗口，而不是在你的程序里显示。要拦截这个行为，需要处理NewWindow3事件。这个事件在 IE7 及以上版本才支持，参数里包含新窗口的 URL，你可以取消默认行为，然后在自己的控件里导航。

void CMyBrowserDlg::OnNewWindow3(LPDISPATCH* ppDisp, VARIANT_BOOL* Cancel, DWORD dwFlags, LPCTSTR bstrUrlContext, LPCTSTR bstrUrl) { *Cancel = VARIANT_TRUE; NavigateToUrl(bstrUrl); }

这个处理方式比弹出一个新窗口要友好得多，用户始终在一个窗口里操作。但要注意，有些网站会通过 JavaScript 的window.open()来弹窗，这个事件同样能拦截到。

4. 常见问题与排查技巧实录

4.1 控件显示空白或无法创建

这是最常见的问题，通常有三个原因。第一，忘记调用AfxEnableControlContainer()。这个函数必须在InitInstance()里、创建主对话框之前调用。第二，控件的 CLSID 没有正确注册。WebBrowser 控件的 CLSID 是{8856F961-340A-11D0-A96B-00C04FD705A2}，正常情况下系统自带，但如果你的系统精简过 IE，可能缺失。第三，对话框的DoDataExchange()里没有正确绑定控件变量。检查DDX_Control的 ID 是否跟资源编辑器里的一致。

还有一个隐蔽的原因：如果你的程序是 64 位的，而系统里的 IE 组件是 32 位的，或者反过来，也会导致控件创建失败。WebBrowser 控件在 64 位系统上既有 32 位版本也有 64 位版本，但 MFC 的 ActiveX 包装类通常只支持 32 位。所以建议把工程配置为 Win32 平台，不要用 x64。

4.2 页面显示错乱或脚本报错

这通常是文档模式的问题。默认的 IE7 模式对现代 CSS 支持很差，flex布局、grid布局、border-radius这些属性都不支持。解决办法就是前面说的设置FEATURE_BROWSER_EMULATION注册表项。但要注意，这个设置只对当前可执行文件名生效，如果你改了程序名，需要重新设置。

另外，有些网站会检测navigator.userAgent，发现是 IE 就跳转到“不支持浏览器”的提示页。这时候你可以通过UrlMkSetSessionOption来修改 User-Agent 字符串，伪装成 Chrome 或 Edge。这个 API 在urlmon.h里声明，调用方式如下：

#include <urlmon.h> #pragma comment(lib, "urlmon.lib") void SetUserAgent() { const char* ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"; UrlMkSetSessionOption(URLMON_OPTION_USERAGENT, (void*)ua, strlen(ua), 0); }

这个调用必须在创建 WebBrowser 控件之前执行，否则不生效。

4.3 内存泄漏与 COM 对象释放

WebBrowser 控件涉及大量的 COM 接口调用，每次QueryInterface或get_XXX得到的指针都需要Release()。如果你在DocumentComplete里获取了IHTMLDocument2指针但没有释放，程序运行一段时间后就会内存暴涨。我的经验是：凡是调用QueryInterface、get_Document、get_parentWindow得到的指针，用完之后立刻Release()，不要留着跨函数使用。

另外，MFC 的CWebBrowser2包装类在析构时会自动释放底层接口，但如果你手动获取了额外的接口指针，必须自己释放。建议用CComPtr智能指针来管理，这样就不用手动Release()了。虽然 MFC 工程默认不包含 ATL，但你可以单独包含atlbase.h来使用CComPtr。

4.4 页面加载慢或卡顿

IE 内核的 JavaScript 引擎性能有限，遇到复杂的单页应用（SPA）会非常卡。如果你的目标页面是 Vue 或 React 写的，WebBrowser 控件可能不是好选择。这时候要么换 WebView2，要么只用来加载静态页面。另外，IE 内核默认会启用一些兼容性检查，可以通过注册表关闭一些不必要的功能来提速，但效果有限。

还有一个常见现象：页面加载时界面无响应。这是因为 WebBrowser 控件的很多操作是同步的，会阻塞 UI 线程。解决办法是把导航操作放在PostMessage里异步执行，或者用多线程处理数据抓取，但 UI 更新仍然要在主线程做。

4.5 常见问题速查表

提示：如果你在调试时发现控件行为异常，可以先在 IE 浏览器里打开同一个页面，看看是否正常。如果 IE 里正常而控件里不正常，那基本就是文档模式或 UA 的问题。

5. 功能扩展与进阶玩法

5.1 添加收藏夹与历史记录

收藏夹的实现很简单：用一个CListBox或者CComboBox显示收藏的 URL 列表，数据存在本地的一个文本文件里，每行一个 URL 加一个标题，用制表符分隔。添加收藏时，获取当前页面的标题和 URL，追加到文件末尾。点击收藏项时，调用NavigateToUrl()跳转。

历史记录稍微复杂一点，需要在DocumentComplete里把 URL 和时间戳写入一个日志文件，然后在界面上提供一个历史记录列表。但要注意去重，同一个 URL 短时间内多次访问只记一次。这个功能对于个人使用来说不是必须的，但做出来会显得更完整。

5.2 页面缩放与字体调整

IE 内核支持通过IHTMLDocument2的get_body()然后设置style.zoom来实现缩放。但更简单的方式是使用IWebBrowser2的ExecWB()方法，传入OLECMDID_OPTICAL_ZOOM命令。这个命令在 IE7 及以上版本支持，可以设置 10 到 1000 的缩放百分比。

void CMyBrowserDlg::SetZoom(int nPercent) { VARIANT vZoom; vZoom.vt = VT_I4; vZoom.lVal = nPercent; m_browser.ExecWB(OLECMDID_OPTICAL_ZOOM, OLECMDEXECOPT_DONTPROMPTUSER, &vZoom, NULL); }

字体调整可以通过ExecWB(OLECMDID_ZOOM)来实现，但效果不如光学缩放好。我的建议是只做光学缩放，用 Ctrl+加号、Ctrl+减号、Ctrl+0 来触发。

5.3 查看页面源码与开发者工具

查看源码的实现方式是：通过IHTMLDocument2获取documentElement的outerHTML，然后弹出一个新窗口显示。但要注意，这样获取到的是经过浏览器解析后的 DOM 结构，跟原始 HTML 可能有差异。如果你需要原始源码，得用URLDownloadToFile或者 WinHTTP 重新下载一遍。

开发者工具就比较麻烦了，IE 内核自带一个简版的 F12 工具，但需要通过ExecWB(OLECMDID_SHOWDEVELOPERTOOLS)来调出，而且界面是独立的窗口，体验一般。对于简易浏览器来说，这个功能可以不做。

5.4 处理 HTTPS 证书错误

IE 内核在遇到自签名证书或过期证书时会弹出一个安全警告对话框，阻止页面加载。如果你的程序需要访问内部 HTTPS 服务，这个对话框会很烦人。解决办法是通过IWebBrowser2的Navigate方法传入navNoReadFromCache和navNoWriteToCache标志，但这不能跳过证书检查。真正跳过证书检查需要实现IServiceProvider和IHttpSecurity接口，比较复杂。

一个取巧的办法是：在BeforeNavigate2事件里判断 URL 是否是 HTTPS，如果是，就先用 WinHTTP 以忽略证书错误的方式下载页面内容，然后用Navigate加载本地临时文件。但这样会丢失 Cookie 和会话状态，只适合静态页面。

6. 个人实操心得与踩坑记录

6.1 关于文档模式的坑

我一开始做这个项目的时候，没有设置FEATURE_BROWSER_EMULATION，结果加载一个用 Bootstrap 写的页面，布局全乱了，按钮重叠、文字溢出。我以为是 CSS 写错了，调了半天才发现是文档模式的问题。后来设置了 IE11 模式，页面立刻正常了。这个坑我踩了整整一个下午，所以把它放在第一个说。

另外要注意，FEATURE_BROWSER_EMULATION的值11001和11000有细微差别：11001是“边缘模式”，会忽略X-UA-Compatible元标签；11000是“标准模式”，会遵循页面的X-UA-Compatible设置。大多数情况下用11001就行，但如果你的页面依赖X-UA-Compatible来指定文档模式，那就用11000。

6.2 关于 COM 初始化的坑

MFC 对话框程序默认会在InitInstance()里调用AfxOleInit()，这个函数会初始化 COM 库。但如果你是在一个非 MFC 的 Win32 程序里使用 WebBrowser 控件，必须手动调用OleInitialize()或CoInitializeEx()。而且要注意，COM 的初始化模式必须是COINIT_APARTMENTTHREADED，不能用COINIT_MULTITHREADED，否则控件无法正常工作。

还有一个坑：如果你在InitInstance()里调用了AfxOleInit()，但在对话框关闭时没有调用AfxOleTerm()，程序退出时可能会报内存泄漏。虽然不影响功能，但调试输出里一堆警告看着不舒服。解决办法是在ExitInstance()里调用AfxOleTerm()。

6.3 关于事件触发的坑

DocumentComplete事件在页面包含 iframe 时会触发多次，这个前面提过了。但还有一个更隐蔽的问题：如果你在DocumentComplete里调用Navigate()跳转到另一个页面，可能会触发递归调用，导致栈溢出。我的做法是在DocumentComplete里设置一个标志位，如果正在跳转中，就忽略后续的DocumentComplete。

另外，StatusTextChange事件在页面加载过程中会频繁触发，如果你在事件处理函数里做了耗时操作，会导致界面卡顿。所以这个函数里只做最简单的字符串设置，不要做任何计算或 IO。

6.4 关于部署的坑

WebBrowser 控件虽然系统自带，但在一些 Windows Server 版本上，IE 的增强安全配置（ESC）会默认开启，导致控件无法加载页面，或者频繁弹出安全警告。解决办法是在服务器管理器里关闭 IE ESC，或者通过注册表禁用。但如果是给客户部署，你不能要求客户去改服务器配置，所以最好在程序启动时检测并提示。

还有一个部署问题：如果你的程序需要以管理员权限运行，WebBrowser 控件在管理员权限下可能无法正常渲染，因为 IE 的保护模式在管理员权限下会被禁用。这个问题的解决办法是让程序以普通权限运行，或者通过CoCreateInstance以低完整性级别创建控件，但后者比较复杂。

6.5 最后的建议

如果你只是想做一个小工具，用来展示本地 HTML 帮助文档或者简单的内部网页，WebBrowser 控件完全够用，而且开发速度极快，半天就能出一个能用的版本。但如果你需要加载现代网页、支持复杂的 JavaScript 框架、或者需要长期维护，那还是建议直接上 WebView2。WebView2 的 API 更现代，性能更好，而且微软在持续更新。虽然它需要额外的运行时，但现在 Win10 和 Win11 基本都自带了，部署成本已经很低了。

我个人的做法是：对于一次性工具、内部小工具、老系统维护，用 WebBrowser 控件；对于新产品、需要长期迭代的项目，用 WebView2。两者并不冲突，根据场景选择就好。这个简易浏览器的代码我已经用了好几年，虽然界面简陋，但在很多紧急场景下帮我省了不少事。希望这些经验对你有用。