QWebChannel实现JS调用C++需在loadFinished信号触发后注册QObject对象并引入qwebchannel.js；C++调用JS须用runJavaScript()异步执行，注意对象生命周期、CSP策略及Qt版本兼容性。
QWebEngineView 中 JS 调用 C++：用 QWebChannel 注册对象必须在页面加载前完成
JS 无法直接调用 C++，必须通过 QWebChannel 桥接。关键点是：注册时机不对，JS 侧永远拿不到 qt.webChannelTransport 或收不到信号——因为 QWebChannel 需要等网页 DOM 加载完毕、且 Qt 的 JS 注入脚本已执行后才能通信。
常见错误现象：Uncaught ReferenceError: qt is not defined 或 channel.registeredObjects is empty。
- 必须在
QWebEngineView::load()之后、但 在网页首次渲染前 设置QWebChannel，推荐用QWebEnginePage::loadFinished信号的第一次触发（且ok == true）来注册 - 注册的对象需继承
QObject，并用Q_INVOKABLE标记可调用函数，或用Q_PROPERTY+NOTIFY暴露属性 - 网页中必须手动引入
qrc:/qtwebchannel/qwebchannel.js（Qt 自带，无需额外下载），且初始化顺序不能错：const channel = new QWebChannel(qt.webChannelTransport);<br>channel.registeredObjects.example = ...;
- 若页面使用了 CSP（Content Security Policy），需允许
script-src 'self' 'unsafe-inline'，否则qwebchannel.js可能被拦截
QWebEngineView 中 C++ 调用 JS：用 runJavaScript() 但要注意执行时机和返回值处理
runJavaScript() 是唯一安全的同步 JS 执行入口，但它不阻塞 C++ 线程，所有结果都通过回调函数异步返回。直接在 loadFinished 里调用仍可能失败——因为 JS 引擎未必就绪，DOM 也未必完全可用。
- 务必等待
QWebEnginePage::loadFinished且状态为true后，再延时一小会儿（如QTimer::singleShot(0, ...)）再执行 JS，避免ReferenceError - JS 代码字符串里不能有未转义的换行或引号；建议用
QStringLiteral包裹，避免编码问题 - 回调函数签名必须是
void(const QVariant &)，QVariant可能为null（JS 返回undefined）、bool、double、QString或嵌套QVariantMap/List，但不支持 JS 的Date、RegExp、函数或循环引用对象 - 若需多次调用或传参复杂，建议在网页中预先定义一个 JS 函数（如
window.invokeCppHandler = function(...){...}），C++ 侧统一调用它，比拼接长字符串更可靠
调试 JS ↔ C++ 通信失败的三个硬检查点
90% 的通信失败不是逻辑问题，而是环境或配置卡点。以下三项必须逐项确认：
-
QWebEngineView所在的QApplication必须已创建，且未调用QWebEngineProfile::defaultProfile()->setHttpCacheType(...)等破坏默认上下文的操作 - 网页中
qwebchannel.js的路径是否正确？Qt 6 默认是qrc:/qtwebchannel/qwebchannel.js，Qt 5.15 及以前可能是qrc:/qtwebchannel/qwebchannel.js或需手动添加资源文件；用浏览器开发者工具 Network 标签确认该 JS 是否 200 加载成功 - C++ 对象注册后，是否被意外释放？比如局部变量注册后函数返回，对象析构 → JS 侧调用直接静默失败；必须确保对象生命周期 >=
QWebChannel和网页生命周期，通常堆分配 +QObject父对象管理最稳妥
Qt 版本差异导致的兼容性陷阱
Qt 5.14+ 和 Qt 6 对 QWebChannel 的行为基本一致，但仍有几个关键差异容易踩坑：
- Qt 6 中
QWebEngineView默认禁用第三方 cookie，若网页 JS 依赖document.cookie回传 token 给 C++，需显式调用page()->profile()->setPersistentCookiesPolicy(QWebEngineProfile::AllowPersistentCookies) - Qt 5.15.2 之前版本存在
runJavaScript()在某些页面（如含 iframe）中回调永不触发的 bug，升级到 5.15.3+ 或 Qt 6.2+ 可解决 - Qt 6.5+ 开始，
QWebEnginePage::runJavaScript()支持QWebEngineScript::MainWorld参数控制执行上下文，默认是MainWorld；若网页用了沙箱 iframe，需显式指定世界（World）才能访问其 JS 环境 - 所有跨语言调用都绕不开线程：C++ 对象必须在主线程创建（或用
moveToThread(QApplication::instance()->thread())），JS 回调也只在主线程触发，切勿在子线程直接操作QWebEngineView
实际项目里最常被忽略的是对象生命周期和 CSP 策略——前者让 JS 调用无声无息消失，后者让 qwebchannel.js 根本加载不了，连错误提示都不给。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
