VSCode端JavaScript调试插件冲突导致的端口占用问题

雨萱小哥_8114

雨萱小哥_8114

2026-09-15

377人浏览

原创

应禁用已弃用的 debugger for chrome 插件,保留 vscode 内置 javascript debugger;若必须共存,则需手动修改 chrome 插件端口(如 9230)并在 launch 模式下通过 runtimeargs 设置 --inspect=9230。

vscode端javascript调试插件冲突导致的端口占用问题

Debugger for Chrome 和 JavaScript Debugger 插件共存会抢 9229 端口

VSCode 默认的 Node.js 调试器(JavaScript Debugger)和旧版 Debugger for Chrome 插件默认都监听 9229 端口。两者同时启用时,后启动的那个会报 EADDRINUSE,但错误提示往往只说“端口被占用”,不指明是哪个插件在占——实际是它们自己在打架。

常见现象:
• 启动 Node 调试会话失败,控制台显示 Unable to attach to process: connect ECONNREFUSED 127.0.0.1:9229
• 切换到 Chrome 调试配置时,Node 调试突然失效,反之亦然
lsof -ni :9229 查到 PID 对应进程名是 Code HelperElectron,而非外部 node 进程

  • 根本原因不是系统服务占端口,而是 VSCode 内部两个调试扩展注册了同一 V8 inspect 端口
  • Debugger for Chrome 已被官方标记为“deprecated”,JavaScript Debugger 是内置替代品(VSCode 1.47+ 默认启用)
  • 禁用其中一个即可:推荐保留内置的 JavaScript Debugger,卸载 Debugger for Chrome
  • 如果必须保留 Chrome 插件(比如依赖其旧版 DevTools UI),则需手动改它的端口:在 VSCode 设置里搜 debug.javascript.chrome.port,设为 9230 或其他空闲值

launch.json 的 port 字段只管 attach 模式,不管 launch 模式

很多人在 .vscode/launch.json 里把 "port" 改成 9230,结果还是报 9229 占用——因为这个字段仅在 "request": "attach" 时生效;而 "request": "launch"(即直接运行 Node 脚本)默认仍走 --inspect 的自动分配逻辑,除非你显式加 "runtimeArgs"

正确写法示例(launch 模式下强制指定 inspect 端口):

{
  "type": "node",
  "request": "launch",
  "name": "Launch with custom inspect port",
  "program": "${file}",
  "runtimeArgs": ["--inspect=9230"],
  "console": "integratedTerminal"
}
  • "port" 字段对 launch 模式无效,纯属误导性配置项
  • --inspect=9230 必须写进 runtimeArgs,且不能带空格(--inspect =9230 会失败)
  • 若项目用 nodemon,还需额外加 --exec node --inspect=9230,否则 nodemon 自己起的子进程仍用默认 9229
  • 改完必须重启整个调试会话,已挂起的 attach 进程不会自动迁移端口

多个工作区同时调试时,端口冲突其实来自同一个 Extension Host

你以为开了两个 VSCode 窗口、两个项目,就该有两套独立调试环境?错。只要它们共享同一个 Extension Host 进程(比如都从同一个 VSCode 实例拖入文件夹),JavaScript Debugger 就只启动一个 V8 inspector 服务,所有 launchattach 请求都排队打向这一个端口。

Java Development Manual
Java Development Manual

Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要:(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

典型表现:
• A 工作区调试正常,B 工作区一启动就报 9229 占用
lsof -ni :9229 查到 PID 对应的是 Code Helper,不是 node
• 关掉 A 的调试会话,B 就立刻能连上

  • 这不是 bug,是 VSCode 架构设计:Extension Host 是单例,调试服务也是单例
  • 解决方法只有两个:要么串行调试(A 停了再开 B),要么拆成独立 VSCode 实例(用 code --new-window --disable-extensions 单独开)
  • 别指望靠改 launch.json 让两个工作区“各用各的端口”——JavaScript Debugger 不支持多实例并发 inspect 服务
  • 如果真要并行,得用 attach 模式 + 外部 node --inspect-brk=9230 启动,让每个项目自己起独立 V8 实例

Chrome 调试器残留的 WebSocket 连接会锁住端口

哪怕你关掉了所有调试面板、停了所有会话,Debugger for Chrome 插件有时会在后台维持一个未关闭的 WebSocket 连接,导致 9229 端口处于 TIME_WAIT 状态,新调试请求仍被拒。

验证方式:
• 在 VSCode 内置终端运行 lsof -ni :9229(macOS/Linux)或 Get-NetTCPConnection -LocalPort 9229(PowerShell)
• 如果输出中 STATETIME_WAITCLOSE_WAIT,说明连接没彻底释放

  • 这不是进程没杀干净,是 TCP 连接状态残留,killtaskkill 无效
  • 临时解法:等 60 秒(Linux/macOS 默认 tcp_fin_timeout),或改系统参数(不推荐)
  • 根治办法:禁用 Debugger for Chrome,改用内置 JavaScript Debugger —— 它对连接生命周期管理更严谨
  • 如果必须用 Chrome 插件,每次调试完手动执行 Developer: Reload Window(Ctrl+Shift+P),强制重置 Extension Host 网络栈

真正容易被忽略的点是:端口冲突未必是“谁在占”,而是“谁不该监听”。
JavaScript DebuggerDebugger for Chrome 的设计目标不同,却共享同一套底层 V8 inspect 接口;强行共存时,VSCode 不会报“插件冲突”,只会把问题转译成“端口被占用”——你查进程、杀 PID、改配置,全在解决表象。最省事的做法,是让其中一个彻底退出历史舞台。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4046

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1029

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

3924

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

820

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1696

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

2985

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

3873

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

2460

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

808

7

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 11.9万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习