渲染进程卡顿需先确认是否真在Chromium线程执行：真实卡顿多发生在renderer.js或preload.js中的DOM操作、Canvas绘制、高频requestAnimationFrame或未节流的事件监听器；验证应通过DevTools Performance火焰图定位耗时函数，若瓶颈在ipcRenderer.invoke回调则属主进程响应慢，而非渲染层问题。
渲染进程卡顿？先确认是否真在Chromium线程里执行
Electron 渲染进程本质是 Chromium 页面，但很多人误把 main.js 里的逻辑当成渲染逻辑调试——结果调了半天，断点根本没进浏览器上下文。真实卡顿往往发生在 renderer.js 或 preload.js 中的 DOM 操作、Canvas 绘制、大量 requestAnimationFrame 循环，或未节流的 resize/scroll 事件监听器上。
验证方法：打开 DevTools → Performance 标签页 → 录制一段操作 → 查看主线程火焰图中耗时最长的函数是否属于你写的渲染代码（而非 Electron 内部 IPC 调用）。若长任务集中在 ipcRenderer.invoke 或 webContents.send 回调里，说明瓶颈其实在主进程响应慢，不是渲染层问题。
- 用
performance.now()手动打点比依赖 DevTools 自动采样更准，尤其对 sub-16ms 的微任务 - 避免在渲染进程直接调用
require('fs')等 Node API——这会触发 IPC 序列化开销，且 Electron 30+ 已默认禁用nodeIntegration - 若使用
contextIsolation: true（推荐），所有跨进程通信必须经由preload.js暴露的 API，不能直接window.api = {...}
preload.js 里写太多逻辑？V8 内存隔离会拖垮首屏
Electron 30 强制启用沙箱后，preload.js 在独立 V8 上下文中执行，与渲染进程主 JS 堆物理隔离。如果 preload 里做了大量计算、缓存构建或初始化大型库（如 Lodash、Moment），会显著延长页面 DOMContentLoaded 时间——实测在 VSCode 2026 + Electron 30 组合下，preload 加载超 120ms 就会导致首屏渲染延迟翻倍。
关键限制：preload 不支持 import 动态加载，所有代码都在主线程同步解析执行。哪怕你用 setTimeout 延迟，也改变不了它被注入的时机早于 DOM 构建这一事实。
- 只暴露必要 API，删掉所有非 IPC 相关的工具函数（比如把格式化日期逻辑移到渲染进程，通过
contextBridge.exposeInMainWorld提供纯函数） - 避免在 preload 里
require('electron').remote——该模块已在 Electron 12+ 废弃，且会触发额外 IPC 路径 - 若必须初始化复杂对象，改用
MessagePort+Transferable传递结构化数据，而非序列化整个对象树
VSCode 调试渲染进程时断点失效？检查 webRoot 和协议匹配
VSCode 用 pwa-chrome 调试器连接 Electron 渲染进程，底层走 Chrome DevTools Protocol（CDP），和主进程的 node 协议完全不兼容。常见现象是：launch.json 配置看着没问题，但断点灰色、控制台报 Breakpoint ignored because generated code not found。
根因几乎总是 webRoot 路径映射错误或调试端口未激活。Electron 启动时若没加 --remote-debugging-port=9222，或 win.webContents.openDevTools() 没被调用，VSCode 就连不到任何 CDP 目标。
-
webRoot必须指向源码目录（如"${workspaceFolder}/src"），不是打包后的dist——否则 sourcemap 映射失败 - 不要用
loadFile('index.html')，改用loadURL('http://localhost:3000')启动本地服务，绕过file://协议下路径解析歧义 - 启动后手动访问
http://localhost:9222/json，返回非空 JSON 列表才表示 CDP 已就绪；返回 404 说明参数没生效或端口被占
Electron 30 + VSCode 2026 渲染冻结？绕过 Blink CORS 冲突
Electron 30 默认启用 --disable-features=OutOfBlinkCors,IsolateOrigins 来修复安全漏洞，但这会破坏 VSCode 2026 的 WebViewBridge 依赖的 Blink CORS 协商机制——表现为渲染进程突然挂起、DevTools 无法连接、webContents.executeJavaScript 调用无响应。
这不是代码 bug，而是运行时契约冲突：VSCode 插件期望通过动态 origin 注入脚本，而 Electron 30 的沙箱策略拒绝了这类跨域资源加载。
- 临时方案：启动 Electron 时显式禁用该限制（仅限开发环境）：
["--disable-features=IsolateOrigins"]，保留OutOfBlinkCors安全补丁 - 长期解法：改用
webviewTag: true+allowpopups属性，在独立 webview 中加载第三方内容，与主窗口沙箱解耦 - 绝对不要在
preload.js里调用document.write或修改document.domain——这会直接触发 Blink 沙箱熔断
