QWebEnginePage::runJavaScript 注入 CSS 易失败，因 DOM 未就绪、iframe 沙箱拦截及异步竞争；推荐用 setUserStyleSheetUrl 加载本地 CSS 文件，需在首次加载前调用且确保文件可读。
QWebEnginePage::runJavaScript 执行 CSS 注入的局限性
直接用 runJavaScript 插入 document.styleSheets 或动态创建 <style> 标签，看似可行，但实际在 Qt WebEngine 中极易失败。原因在于：页面可能尚未完成 DOM 构建，或 Chromium 的子帧（iframe）沙箱策略会拦截非主文档上下文的样式操作；更关键的是，runJavaScript 不保证执行时机，多次调用还可能因异步竞争导致样式覆盖混乱。
推荐方案：使用 setUserStyleSheetUrl 加载外部 CSS 文件
Qt 5.12+ 提供了稳定、声明式的接口：QWebEnginePage::setUserStyleSheetUrl。它由底层 Chromium 原生支持，不依赖 JS 执行时机，且自动应用于所有子帧（包括 iframe），是官方推荐的样式注入方式。
- 准备一个本地 CSS 文件（如
custom.css），路径需为QUrl::fromLocalFile()可解析的绝对路径，不能用相对路径或file://手动拼接 - 必须在
QWebEnginePage实例创建后、首次加载 URL 前调用，否则无效 - 该样式表具有最高层叠优先级（高于网页内联样式和
<style>，但低于!important内联声明） - 不支持跨域远程 URL（如
https://），仅限本地文件
QWebEngineProfile::setHttpUserAgent 配合 CSS 的隐藏品牌场景
如果你的目标是像“隐藏路由器品牌信息”这类需求，单靠 CSS 往往不够——有些品牌水印是 Canvas 绘制或 SVG 内联生成的，CSS 无法覆盖。此时需要组合手段：
- 先用
setUserStyleSheetUrl隐藏已知 DOM 元素（如#brand-logo,.footer-brand） - 再通过
QWebEngineProfile::setHttpUserAgent伪装 UA，避免服务端返回定制化品牌 HTML - 对 Canvas/SVG 类水印，必须配合
runJavaScript注入脚本劫持CanvasRenderingContext2D.prototype.fillText或替换 SVG<text>内容，但这属于 JS 层面修补，不是纯 CSS 方案
QoderWake 的 custom-css 路径配置不适用于通用 Qt 应用
QoderWake 的 css_override_path 是其私有配置项，依赖内部 YAML 解析与自定义加载逻辑，**不能直接套用到你自己的 Qt 项目中**。通用 Qt 应用必须走标准 API：QWebEnginePage::setUserStyleSheetUrl 或（次选）在 QWebEngineView::load 后监听 loadFinished 信号再用 runJavaScript 注入，后者稳定性差，仅作兜底。
立即学习“前端免费学习笔记（深入）”；
容易被忽略的一点是：Qt WebEngine 在 Linux 上默认启用 sandbox，若自定义 CSS 文件权限不正确（如无读取权限），setUserStyleSheetUrl 会静默失败，控制台无报错——务必用 QFileInfo 检查文件是否存在且可读。
