差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 | |||
| electron:调试 [2026/11/03 23:59] – 编写 Electron 调试指南:日志调试与断点调试 张叶安 | electron:调试 [2026/11/03 23:59] (当前版本) – 追加 Electron 调试速查思维导图 张叶安 | ||
|---|---|---|---|
| 行 305: | 行 305: | ||
| ===== 速查思维导图 ===== | ===== 速查思维导图 ===== | ||
| + | |||
| + | ```mdk height=520 color=# | ||
| + | # Electron 调试 | ||
| + | |||
| + | ## 先分清进程 | ||
| + | ### 主进程 | ||
| + | - main.js / app.whenReady | ||
| + | - Node 环境,DevTools 看不到 | ||
| + | ### 渲染进程 | ||
| + | - 页面 Vue/ | ||
| + | - 等于调 Chromium 网页 | ||
| + | ### preload | ||
| + | - contextBridge | ||
| + | - 报错只在 preload-error 里 | ||
| + | |||
| + | ## 断点调试 | ||
| + | ### 渲染进程 | ||
| + | - Ctrl+Shift+I 开 DevTools | ||
| + | - Sources 面板打红点 | ||
| + | - debugger; 临时断点 | ||
| + | - 需 sourcemap 才能命中源码 | ||
| + | ### 主进程 | ||
| + | - electron --inspect=5858 . | ||
| + | - --inspect-brk 首行停住 | ||
| + | - chrome:// | ||
| + | - VS Code launch.json 最省事 | ||
| + | - Windows 用 electron.cmd | ||
| + | ### 远程/ | ||
| + | - --remote-debugging-port=9222 | ||
| + | - webContents.debugger + CDP | ||
| + | ### 卡死排查 | ||
| + | - --inspect 后按 Pause 看栈 | ||
| + | - 查 readFileSync / execSync | ||
| + | - process._getActiveHandles() | ||
| + | |||
| + | ## 日志调试 | ||
| + | ### 坑 | ||
| + | - 主进程 log 只进启动终端 | ||
| + | - 打包后 GUI 无终端=日志全丢 | ||
| + | - 渲染进程 log 只在 DevTools | ||
| + | ### 原生 | ||
| + | - --enable-logging 输出到 stderr | ||
| + | - ELECTRON_ENABLE_LOGGING=1 | ||
| + | ### electron-log | ||
| + | - log.initialize() 一次 | ||
| + | - transports.file.level | ||
| + | - 文件在 app.getPath(' | ||
| + | - preload 暴露给渲染进程 | ||
| + | ### 事件汇总 | ||
| + | - web-contents-created | ||
| + | - console-message 转发 | ||
| + | - did-fail-load 白屏 | ||
| + | - preload-error 必加 | ||
| + | - render-process-gone 崩溃 | ||
| + | ### 兜底 | ||
| + | - uncaughtException | ||
| + | - unhandledRejection | ||
| + | - crashReporter 落本地 | ||
| + | |||
| + | ## 打包后 | ||
| + | ### 难点 | ||
| + | - asar 打包 + 压缩 | ||
| + | - sourcemap 缺失 | ||
| + | ### 对策 | ||
| + | - 用带 sourcemap 的开发构建 | ||
| + | - exe --inspect=5858 仍可用 | ||
| + | - fuses 关掉就不行 | ||
| + | - asar list / extract 看内容 | ||
| + | |||
| + | ## 症状速查 | ||
| + | ### 看不到 log | ||
| + | - 换 electron-log 写文件 | ||
| + | ### 断点是灰的 | ||
| + | - 开 sourcemap / 配路径映射 | ||
| + | ### 白屏 | ||
| + | - did-fail-load + preload-error | ||
| + | ### 改代码不生效 | ||
| + | - 主进程无热重载,重启 | ||
| + | ### 界面卡死 | ||
| + | - 主进程被同步阻塞 | ||
| + | |||
| + | ## 日常工作流 | ||
| + | ### 开发 | ||
| + | - VS Code 调试主进程 | ||
| + | - DevTools 调渲染进程 | ||
| + | ### 留存 | ||
| + | - 关键路径结构化日志 | ||
| + | ### 排障 | ||
| + | - 让用户发日志文件 | ||
| + | ``` | ||