讲师中心 微信公众号
AI工具推荐 视频效率加速

在VSCode中同时调试Electron主进程和渲染进程

阿杰酱_3453

阿杰酱_3453

发布时间:2025-12-18 12:34:03

|

830人浏览过

|

来源于php中文网

原创

可在 VSCode 中同时调试 Electron 主进程和渲染进程,需配置两个调试器:主进程用 node 类型 attach 到 9229 端口,渲染进程用 pwa-chrome attach 到 9222 端口,并通过 compounds 组合启动;注意端口不冲突、source map 启用及渲染进程就绪后再连接。

在vscode中同时调试electron主进程和渲染进程

在 VSCode 中同时调试 Electron 主进程和渲染进程是可行的,关键在于配置两个独立但协同的调试器:一个附加到主进程(Node.js 环境),另一个附加到 Chromium 渲染进程(Chrome DevTools 协议)。Electron 12+ 默认启用 inspect 和 remote-debugging-port,无需额外启动参数,但需确保调试配置正确。

1. 启用 Electron 的远程调试能力

Electron 默认已开启主进程调试(--inspect)和渲染进程调试(--remote-debugging-port),但为明确控制,建议在启动脚本中显式指定:

  • 主进程调试端口默认为 9229(可改)
  • 渲染进程调试端口推荐设为 9222(避免与主进程冲突)
  • 在 package.json 的启动命令中加入:
    "scripts": { "dev": "electron --inspect=9229 --remote-debugging-port=9222 ." }

2. 配置 launch.json 支持双进程调试

在项目根目录的 .vscode/launch.json 中添加两个配置,使用 compounds 实现一键启动双调试:

Html2md
Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载
  • 第一个配置(Launch Main Process):类型 node,端口 9229,request 为 attach,并设置 protocol 为 inspector
  • 第二个配置(Attach to Renderer):类型 pwa-chrome 或 chrome(VSCode 1.85+ 推荐 pwa-chrome),request 为 attach,port 设为 9222,webRoot 指向渲染进程 HTML 所在目录(如 ${workspaceFolder}/src)
  • 添加 compounds 项,组合两者:
    "compounds": [{ "name": "Debug Electron", "configurations": ["Launch Main Process", "Attach to Renderer"] }]

3. 正确触发渲染进程调试连接

仅靠启动 Electron 不足以让 VSCode 自动连接渲染进程——必须等窗口创建且 DevTools 协议就绪。常见做法:

  • 在主进程中,于 win.loadURL(...) 后加一行:
    win.webContents.openDevTools();(可选,便于手动验证)
  • 确保渲染进程页面已加载完成(例如监听 did-finish-load 事件后再执行调试操作)
  • VSCode 的 Attach to Renderer 配置会在 Electron 启动后自动尝试连接端口 9222;若失败,检查是否被其他进程占用,或 Electron 是否真正启用了该端口(可通过 http://localhost:9222/json 查看可用页面列表)

4. 调试时的注意事项

双进程调试不是“完全同步”,但能各自断点、查看变量、调用栈:

  • 主进程断点停在 main.js 或 IPC 处理逻辑中,不影响渲染进程 UI 响应(除非阻塞主线程)
  • 渲染进程断点停在 renderer.js 或 Vue/React 组件中,可直接 inspect DOM、console、localStorage
  • IPC 调试需配合两端:主进程收消息处打点 + 渲染进程发消息处打点,注意消息体序列化限制(不能传函数、原型链对象)
  • 若使用 Webpack/Vite 构建渲染进程,确保 source map 已启用(devtool: 'source-map'),否则断点可能错位

基本上就这些。配置一次后,按 Ctrl+Shift+D 选中 Debug Electron,点绿色三角即可同时进入两个上下文。不复杂但容易忽略端口冲突和 source map 设置。

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2195

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3462

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1156

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3979

2025.09.10

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

2826

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5639

2023.11.06

Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

4027

2026.03.24

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

6247

2023.07.18

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

20

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 17.3万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 2.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn