Electron 開発ツール

Electron 開発ツールとしては VS Code の使用をおすすめします。まだ VS Code に慣れていない場合は、私たちのチュートリアルを参照してください:VS Code チュートリアル。

VS Code ダウンロード先:https://code.visualstudio.com/。

VS Code 自体が Electron で構築されているため、Electron 開発に対して自然なサポート利点があります:

  • 内蔵ターミナル統合
  • 強力なデバッグ機能
  • 豊富なプラグインエコシステム
  • Git 統合
  • IntelliSense スマート提案
  • 完全無料かつオープンソース

VS Code 必須プラグインのおすすめ

プラグイン名 機能説明
Electron Snippets Electron API のコードスニペットと自動補完を提供
Prettier – Code Formatter コードスタイルを統一し、自動フォーマット
ESLint 構文エラーとスタイルの問題をチェック
Debugger for Chrome VS Code 内でフロントエンドのレンダープロセスをデバッグ可能にする
Node.js Modules Intellisense Node.js モジュール関数を自動提案
Path Intellisense ファイルパスのスマート提案
npm Intellisense npm パッケージ名を自動提案
Auto Rename Tag / Auto Close Tag HTML タグのスマート補完
GitLens Git コードバージョンの可視化体験を向上

Chrome DevTools デバッグ(レンダープロセス)

Electron のレンダープロセスは実際にはChromium ブラウザのページです,
そのため、ウェブページをデバッグするのと同じように、Chrome DevTools で直接デバッグできます。

DevTools を有効にする

にmain.jsウィンドウ作成時に追加:

例

const win = new BrowserWindow({
  width: 800,
  height: 600
});
win.loadFile('index.html');

// 開発者ツールを開く
win.webContents.openDevTools();

デバッグできる内容

  • HTML / CSS / JS コード
  • ネットワークリクエスト(Network)
  • コンソールログ(Console)
  • DOM 構造
  • パフォーマンス分析(Performance)
  • メモリリーク(Memory)

ヒント

レンダープロセスのデバッグは Chrome とほぼ同じです。そのため:

  • 以下を使用できます:console.log()デバッグ情報を出力
  • Chrome のショートカットキー(Cmd + Option + I / Ctrl + Shift + I)で DevTools を開くこともできます

Electron メインプロセスのデバッグテクニック

メインプロセスはウェブページではなく Node.js 環境のため、デバッグ方法はウェブページとは異なります。

方法1:VS Code 内蔵デバッガを使用

プロジェクトのルートディレクトリに.vscode/launch.jsonファイルを作成します。

内容は以下の通りです(そのまま使用可能):

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Electron 主进程调试",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/node_modules/electron/dist/electron.js",
      "args": ["."],
      "outputCapture": "std",
      "runtimeExecutable": null,
      "cwd": "${workspaceFolder}"
    }
  ]
}

その後、main.jsにブレークポイントを設定し、デバッグ ▶️ をクリックするだけです。

方法2:コマンドラインによるリモートデバッグ

起動時にパラメータを追加:

electron . --inspect=5858

その後、Chrome のアドレスバーで以下を開きます:

chrome://inspect

メインプロセスにリモート接続でき、Node.js をデバッグするようにブレークポイントデバッグができます。


よくあるデバッグテクニックまとめ

デバッグ対象 ツール/方法 説明
ウィンドウ画面のカクつき Chrome DevTools → Performance レンダリングの所要時間、JS 実行のボトルネックを分析
ウィンドウの突然終了 メインプロセスで try/catch を追加するか、electron-logログ記録を使用 メインプロセスの例外をキャッチ
IPC 通信の異常 にipcMain / ipcRendererにログを追加 メインとレンダー間の通信をデバッグ
ファイルパスエラー を使用path.join(__dirname, 'xxx') 相対パスの問題を回避
パッケージングデバッグ を使用electron-builder --dirまずディレクトリモードでビルド 直接実行してデバッグ可能

上級者向けツールのおすすめ

ツール 用途
Electron Forge 公式推奨のスキャフォールディングツール。プロジェクトの作成・パッケージングを迅速に行う
Electron Builder 強力なパッケージング・リリースツール
Electron Reload ファイル変更後にアプリを自動リフレッシュ
Spectron Electron アプリの自動化テストに使用
Devtron Electron 公式デバッグ拡張機能。アプリの内部状態を分析
React / Vue DevTools フロントエンドフレームワークを使用する場合、コンポーネントの状態デバッグに非常に便利

VS Code で書き、DevTools で確認し、launch.json でデバッグし、Builder でパッケージングする——これがプロの Electron 開発者の完全なツールチェーンです。

その他の拡張機能