# 9.2.在 node-inspector 中调试主进程
[`node-inspector`][node-inspector] 提供了一个熟悉的开发者工具 GUI,可以用在 Chrome 中调试 Electron 主进程,然而,因为 `node-inspector` 依赖于一些原生 Node 模块,它们必须以你希望调试的版本的 Electron 为目标重新编译。你可以自己重新编译 `node-inspector` 的依赖关系,或者让 [`electron-inspector`][electron-inspector] 为你完成,这个文档覆盖这两种途径。
**注意**: 在编写的时候,最新版的 `node-inspector` (0.12.8)如果没有修复其中一个依赖关项时,不能以 Electron 1.3.0 或者更新的版本为目标重新编译。如果你使用 `electron-inspector` ,它会为你考虑这点。
## 使用 `electron-inspector` 来调试
### 1. 安装 [node-gyp required tools][node-gyp-required-tools]
### 2. 如果你还没有安装过,先安装 [`electron-rebuild`][electron-rebuild]
```shell
npm install electron-rebuild --save-dev
```
### 3. 安装 [`electron-inspector`][electron-inspector]
```shell
npm install electron-inspector --save-dev
```
### 4. 启动 Electron
使用 `--debug` 开关运行 Electron:
```shell
electron --debug=5858 your/app
```
或者,要暂停 JavaScript 的第一行的执行:
```shell
electron --debug-brk=5858 your/app
```
### 5. 启动 electron-inspector
macOS / Linux:
```shell
node_modules/.bin/electron-inspector
```
Windows:
```shell
node_modules\\.bin\\electron-inspector
```
`electron-inspector` 在第一次运行时需要重建 `node-inspector` 依赖关系,包括任何时候你修改了你的 Electron 版本时。重建过程可能需要一个网络连接来下载 Node headers 和 库,可能花费一些时间。
### 6. 载入调试工具 UI
在 Chrome 浏览器中打开 http://127.0.0.1:8080/debug?ws=127.0.0.1:8080&port=5858 。如果使用 `--debug-brk` 启动,你可能需要点击暂停来强制更新 UI。
## 使用 `node-inspector` 来调试
### 1. 安装 [node-gyp required tools][node-gyp-required-tools]
### 2. 安装 [`node-inspector`][node-inspector]
```bash
$ npm install node-inspector
```
### 3. 安装 [`node-pre-gyp`][node-pre-gyp]
```bash
$ npm install node-pre-gyp
```
### 4. 为 Electron 重新编译 `node-inspector` `v8` 模块
**注意:** 更新目标参数为你的 Electron 版本号
```bash
$ node_modules/.bin/node-pre-gyp --target=1.2.5 --runtime=electron --fallback-to-build --directory node_modules/v8-debug/ --dist-url=https://atom.io/download/atom-shell reinstall
$ node_modules/.bin/node-pre-gyp --target=1.2.5 --runtime=electron --fallback-to-build --directory node_modules/v8-profiler/ --dist-url=https://atom.io/download/atom-shell reinstall
```
也可以查看 [如何安装原生模块][how-to-install-native-modules]。
### 5. 为 Electron 启用调试模式
也可以通过一个调试开关启动 Electron,如下:
```bash
$ electron --debug=5858 your/app
```
或者,在第一行暂停你的脚本:
```bash
$ electron --debug-brk=5858 your/app
```
### 6. 使用 Electron 启动 [`node-inspector`][node-inspector] 服务
```bash
$ ELECTRON_RUN_AS_NODE=true path/to/electron.exe node_modules/node-inspector/bin/inspector.js
```
### 7. 载入调试工具 UI
在 Chrome 浏览器中打开 http://127.0.0.1:8080/debug?ws=127.0.0.1:8080&port=5858 。如果使用 `--debug-brk` 启动,必须点击暂停查看入口行。
* [electron-inspector]: https://github.com/enlight/electron-inspector
* [electron-rebuild]: https://github.com/electron/electron-rebuild
* [node-inspector]: https://github.com/node-inspector/node-inspector
* [node-pre-gyp]: https://github.com/mapbox/node-pre-gyp
* [node-gyp-required-tools]: https://github.com/nodejs/node-gyp#installation
* [how-to-install-native-modules]: 【使用Node 原生模块】
- 索引
- 前言.关于Electron
- 第一部分 开发指南
- 第1章.平台支持
- 第2章.安全、原生功能和你的责任
- 第3章.版本说明
- 第4章.发行应用
- 第5章.Mac App商店提交指南
- 第6章.Windows商店指南
- 第7章.应用打包
- 第8章.使用Node原生模块
- 第9章.调试主进程
- 9.1.在VSCode中调试
- 9.2.在node-inspector中调试
- 第10章.使用Selenium和WebDriver
- 第11章.DevTools扩展
- 第12章.使用Pepper Flash插件
- 第13章.使用Widevine CDM插件
- 第14章.通过自动化持续集成系统进行测试
- 第15章.离屏渲染
- 第二部分 使用教程
- 第16章.快速入门
- 第17章.桌面环境集成
- 第18章.在线/离线事件探测
- 第19章.应答式编译器(REPL)
- 第三部分 API参考
- 第20章.API简介
- 第21章.进程对象
- 第22章.Chrome的命令行开关
- 第23章.环境变量
- 第24章.定制的DOM元素
- 24.1.File 对象
- 24.2.webview 标签
- 第25章.主进程模块
- 25.1.app
- 25.2.BrowserWindow
- 25.3.无框架窗口
- 第26章.渲染进程模块
- 第27章.两种进程可用的模块
- 第四部分 高级主题
- 附 FAQ
- 附 文档规范
- 附 示例用例
- 1.无边框窗口