electron:调试

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
electron:调试 [2026/11/03 23:59] – 编写 Electron 调试指南:日志调试与断点调试 张叶安electron:调试 [2026/11/03 23:59] (当前版本) – 追加 Electron 调试速查思维导图 张叶安
行 305: 行 305:
  
 ===== 速查思维导图 ===== ===== 速查思维导图 =====
 +
 +```mdk height=520 color=#4f46e5
 +# Electron 调试
 +
 +## 先分清进程
 +### 主进程
 +- main.js / app.whenReady
 +- Node 环境,DevTools 看不到
 +### 渲染进程
 +- 页面 Vue/React/DOM
 +- 等于调 Chromium 网页
 +### preload
 +- contextBridge
 +- 报错只在 preload-error 里
 +
 +## 断点调试
 +### 渲染进程
 +- Ctrl+Shift+I 开 DevTools
 +- Sources 面板打红点
 +- debugger; 临时断点
 +- 需 sourcemap 才能命中源码
 +### 主进程
 +- electron --inspect=5858 .
 +- --inspect-brk 首行停住
 +- chrome://inspect 加 localhost:5858
 +- 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('logs')
 +- 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 调渲染进程
 +### 留存
 +- 关键路径结构化日志
 +### 排障
 +- 让用户发日志文件
 +```
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • electron/调试.1793721579.txt.gz
  • 最后更改: 2026/11/03 23:59
  • 由 张叶安