应使用WebView2控件替代传统WebBrowser控件，通过NuGet引入、初始化CoreWebView2Controller、配置安全参数、桥接JS/C++通信、适配高DPI及离线资源打包，实现MFC对HTML5的完整支持。
如果您正在维护一个传统的MFC桌面应用程序，并希望在其中嵌入现代Web界面（如HTML5页面），则需解决MFC原生Web控件对HTML5标准支持不足的问题。以下是实现MFC项目兼容HTML5技术的集成步骤：
一、替换为WebView2控件
WebView2基于Chromium内核，提供完整的HTML5、CSS3、JavaScript ES6+及Web API支持，是微软官方推荐的现代Web嵌入方案。它可替代已停更且仅支持IE内核的WebBrowser控件。
1、在Visual Studio中安装Microsoft.Web.WebView2 NuGet包，确保版本不低于1.0.1460.1。
2、在MFC对话框或视图类头文件中包含头文件：#include "WebView2.h"。
立即学习“前端免费学习笔记（深入）”；
3、在资源编辑器中添加一个Static控件作为WebView2的父窗口容器，并为其设置唯一ID（如IDC_WEBVIEW_HOST）。
4、在OnInitDialog()或OnInitialUpdate()中调用CreateCoreWebView2ControllerAsync，传入该Static控件的HWND句柄。
5、等待CoreWebView2Controller创建完成，在回调中调用Navigate()加载本地HTML5页面（如L"file://./res/index.html"）或远程URL。
二、启用本地文件系统访问权限
WebView2默认禁止file://协议下的跨目录读取与AJAX请求，而HTML5应用常依赖本地资源路径。需显式配置环境参数以解除限制。
1、在初始化WebView2前，构造CoreWebView2EnvironmentOptions对象，并将AdditionalBrowserArguments设为"--disable-web-security --allow-file-access-from-files"。
2、调用CreateCoreWebView2EnvironmentWithOptions，传入上述options指针，再使用返回的environment对象启动controller。
3、确认HTML5页面中引用的CSS、JS、图片等资源路径为相对路径或file://绝对路径，且位于同一目录或子目录下。
三、桥接C++与HTML5 JavaScript
为使MFC逻辑能响应HTML5页面事件（如按钮点击）、或让JavaScript调用C++功能（如读写注册表），需建立双向通信通道。
1、在CoreWebView2对象上注册自定义主机对象：调用AddHostObjectToScript()，传入IDispatch派生类实例（如CWebViewHostObject）及对象名（如L"external"）。
2、在CWebViewHostObject中实现IDispatch接口，重载Invoke方法，对JavaScript调用的方法名进行字符串匹配并分发至对应C++函数。
3、在HTML5页面中通过window.external.invokeCpp("saveData", JSON.stringify(data))触发C++处理逻辑。
4、从C++向JavaScript发送消息时，调用ExecuteScript()执行字符串形式的JS代码，例如注入全局变量或触发自定义事件。
四、处理高DPI与缩放适配
MFC默认不自动适配高DPI显示器，而HTML5页面在缩放比例非100%时可能出现布局错乱、字体模糊或触摸事件偏移问题。
1、在MFC项目属性中启用“高DPI支持”，设置Manifest文件中的dpiAware值为true/pm。
2、在WebView2初始化完成后，调用put_DefaultBackgroundColor()设置透明背景色，避免DPI缩放导致的色块残留。
3、在HTML5页面的
中添加meta标签：。4、在CSS中使用rem或vmin单位替代px，并通过JavaScript监听window.devicePixelRatio变化，动态调整根元素font-size。
五、离线资源打包与路径映射
HTML5应用常依赖外部资源（如WebAssembly模块、音视频文件、本地数据库），需确保发布时所有依赖被正确打包并可在无网络环境下访问。
1、将HTML5项目整个输出目录（含index.html、js/、css/、assets/等）复制到MFC安装包的Resources子目录中。
2、使用GetModuleFileName获取当前EXE路径，拼接出HTML5资源根路径，例如：CString htmlRoot = exePath.Left(exePath.ReverseFind('\\')) + L"\\Resources\\";。
3、调用Navigate()时传入file://格式URL，但需将反斜杠转换为正斜杠，并使用UrlEncode对路径中空格和中文字符编码。
4、若需拦截特定HTTP请求（如/api/data）并由C++模拟响应，可注册WebResourceRequested事件，在事件处理器中检查Request.Uri，匹配后调用TryGetResponse()返回自定义HttpResponseStream。
