讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

Laper
Laper

剧本策划到成片协作

VSCode子进程调试中断与自动附加配置教程

小敏大大_5656

小敏大大_5656

发布时间:2026-11-21 05:06:49

|

752人浏览过

|

来源于php中文网

原创

VSCode默认不调试子进程,断点不触发是因调试会话未覆盖子进程;必须设"autoAttachChildProcesses":true(仅对"type":"node"且"request":"launch"生效),用fork()而非spawn(),确保Node≥14、端口不冲突、路径绝对且重启调试会话。

vscode子进程调试中断与自动附加配置教程

VSCode 默认不调试子进程,断点不触发不是代码问题,而是调试会话根本没覆盖到子进程——必须显式启用自动附加机制,并确保父子进程都满足调试握手条件。

Node.js 子进程断点不触发:检查 autoAttachChildProcesses 是否生效

这个字段只在 "type": "node" 且 "request": "launch" 的 launch 配置中起作用,pwa-node 或 attach 模式下完全忽略它。常见错误包括:

  • 误用 "type": "pwa-node":老项目迁移时容易保留该配置,但 autoAttachChildProcesses 不支持 pwa-node
  • launch.json 里写了 "request": "attach":autoAttachChildProcesses 对 attach 模式无效,必须改回 "launch"
  • 配置写在错误的 configuration 下:比如你有多个配置项,但 autoAttachChildProcesses: true 只加在了测试配置里,而实际运行的是开发配置
  • 没重启调试会话:改完 launch.json 后必须停止当前调试并重新按 F5,热重载不生效

子进程启动方式决定能否被自动附加

child_process.fork() 是唯一被 VSCode JS Debugger 原生支持的自动附加路径;spawn() 默认不触发自动附加,除非你手动加 --inspect 并确保命令以 node 开头。

VSCode节点工具(专业版)
VSCode节点工具(专业版)

面向团队的企业级IDE远程操作平台,含调试、测试、终端、Agent委托与团队协作能力。

下载
  • ✅ 推荐:fork('./worker.js') —— 无需传 --inspect,VSCode 自动注入
  • ❌ 避免:spawn('node', ['worker.js']) —— 缺少 --inspect,且未指定端口,VSCode 无法识别为可调试 Node 子进程
  • ⚠️ 强行用 spawn():必须写成 spawn('node', ['--inspect=0.0.0.0:9230', 'worker.js']),且端口不能与主进程(默认 9229)冲突
  • ? Windows 上用 cmd /c node worker.js 包裹:VSCode 无法识别为 Node 进程,autoAttach 失效

Python 多进程调试:依赖 subProcess: true 和 debugpy 版本

Python 扩展从 1.84+ 开始支持 "subProcess": true,但它不是魔法开关——底层靠 debugpy 注入,因此版本和初始化时机很关键。

  • 必须安装 debugpy >= 1.6.0,且主进程和所有子进程环境都要能 import 到(虚拟环境隔离时尤其注意)
  • "subProcess": true 仅对 "type": "python" + "request": "launch" 生效,不能用于 attach 配置
  • 若子进程由 subprocess.Popen(['python', ...]) 启动,而非 multiprocessing 或 concurrent.futures,则不会被自动捕获
  • 断点显示为空心圆?检查子进程工作目录是否与 VSCode 当前 workspaceFolder 一致;路径不匹配会导致 source map 解析失败

端口、超时与进程层级的隐藏限制

VSCode 的自动附加不是无条件监听所有子进程,它有明确边界和容错窗口。

  • 端口必须唯一:主进程用 9229,子进程建议用 9230、9231 等,重复会触发 EADDRINUSE,子进程静默崩溃
  • 只 attach 直接子进程:由主进程 fork() 启动的进程会被捕获,但该子进程再 fork() 出来的“孙进程”不会
  • 5 秒超时机制:子进程启动后需在 5 秒内暴露调试端口,否则 VSCode 放弃等待;可加 "timeout": 10000 延长
  • Node.js 版本底线是 ≥ 14:低于此版本 async_hooks 不稳定,部分子进程生命周期事件可能丢失

真正难调的场景(比如 worker_threads 和 child_process 混用、或子进程又启动了 shell 命令),别强依赖自动附加——改用 --inspect-brk + 手动 attach 更可控,而且能第一时间确认子进程是否真的跑起来了。

热门AI工具

更多
Seko
Seko Hot

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

DeepSeek

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

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

WorkBuddy

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

豆包大模型

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

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

1695

2023.06.30

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3712

2023.07.21

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2209

2024.03.14

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1787

2024.03.14

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2667

2024.03.15

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1878

2024.03.15

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1322

2024.03.15

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1176

2024.03.15

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

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

精品课程

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

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