VSCode如何使用开发者工具排查问题_VSCode开发者工具排查问题大全

星枫姑娘_9188

星枫姑娘_9188

2026-04-04

789人浏览

原创

vscode 的开发者工具即 chromium devtools,通过 ctrl+shift+i(win/linux)或 cmd+option+i(macos)打开,用于调试渲染进程;主进程需用 launch extension 模式调试,console 中无法访问 vscode api。

vscode如何使用开发者工具排查问题_vscode开发者工具排查问题大全

VSCode 的开发者工具在哪打开

VSCode 自身没有独立的“开发者工具”面板,它用的是 Chromium 内置的 DevTools —— 本质就是 Electron 应用的调试界面。打开方式非常固定:Ctrl+Shift+I(Windows/Linux)或 Cmd+Option+I(macOS)。这个快捷键直接唤起渲染进程的 DevTools,和 Chrome 打开网页开发者工具一模一样。

注意:必须在 VSCode 窗口获得焦点时按,如果当前焦点在编辑器里但光标在代码中,依然有效;但如果焦点在弹出的系统对话框(比如“保存文件”窗口)上,会失效。

  • 快捷键无效?先确认是否被系统或其他软件劫持(比如某些键盘管理工具会吞掉 Ctrl+Shift+I)
  • 菜单路径是:Help → Toggle Developer Tools,可作为备用入口
  • 打开后看到的是“Elements”、“Console”、“Sources”等标签页,不是 VSCode 扩展界面本身

为什么在 Console 里打 console.log 没反应

VSCode 的主进程(main process)和渲染进程(renderer process)是分离的。你在 DevTools 的 Console 里输入代码,运行在渲染进程上下文中,而大多数扩展逻辑、配置读取、文件系统操作都跑在主进程中 —— 它们彼此不共享全局作用域。

所以你敲 console.log('hello') 能执行,但想查 vscode.workspace 或调用 vscode.window.showInformationMessage 会报错:ReferenceError: vscode is not defined。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • 要调试扩展逻辑,必须用 Launch Extension 启动模式,在 Extension Development Host 窗口中打开 DevTools
  • 主进程日志看 Help → Toggle Developer Tools 后切换到 Console 标签,但只显示渲染层错误(如 UI 组件崩溃、CSS 加载失败)
  • 真正有用的日志在 Developer: Open Logs Folder 命令里,对应路径类似 ~/.vscode/logs/

如何定位扩展导致的卡顿或崩溃

卡顿大概率是某个扩展在主线程做了重操作(比如同步读大文件、正则回溯爆炸),崩溃常源于 native 模块异常或内存泄漏。DevTools 的 Performance 和 Memory 标签能辅助判断,但关键第一步是隔离问题来源。

  • 启动时加 --disable-extensions 参数:code --disable-extensions,确认是否恢复流畅
  • 逐个禁用可疑扩展,尤其那些带“file watcher”、“auto-format”、“git lens”字样的
  • 在 DevTools 的 Performance 面板录制操作(比如打开一个大文件),重点关注 Scripting 时间占比高的任务,点击展开能看到具体调用栈,常含扩展 ID(如 vscode.git)
  • 崩溃后查看 Help → Toggle Developer Tools → Console 是否有 ERR! 开头的红色错误,例如 ERR! Extension host terminated unexpectedly

调试 Webview 或 Notebook 渲染器时 DevTools 不生效

Webview 和 Notebook 的内容运行在独立的沙箱渲染器进程中,它们的 DevTools 默认不随主窗口一起打开。你得手动触发 —— 右键 Webview 区域(比如 Markdown 预览窗),选择 Inspect;或者在 Notebook 单元格右键选 Inspect Element。

这时打开的是该 Webview 实例专属的 DevTools,console 里能访问到 acquireVsCodeApi() 返回的对象,也能看到自己注入的脚本执行情况。

  • 如果右键没出现 Inspect,说明该 Webview 设置了 enableScripts: false 或启用了 localResourceRoots 限制
  • Notebook 渲染器调试前建议关闭 notebook.experimental.useSeparateRendererProcess(设为 false),否则多个渲染器进程会让调试目标变模糊
  • Webview 中的 fetch 请求走的是 VSCode 内置代理,不会出现在 Network 面板,要用 console.log 或 debugger 配合断点查
实际排查中最容易被忽略的,是误把渲染进程的 DevTools 当成“VSCode 全局调试器”——它看不到主进程变量、扩展会话状态、插件激活时机,也抓不到 Node.js 层的堆栈。真要深挖,得切到正确的进程上下文,再配合日志路径和命令行参数组合使用。

相关文章

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

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

下载

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

相关专题

更多
chrome什么意思
chrome什么意思

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

2023.08.11

2546

5

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

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

2023.11.06

4579

7

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

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

2026.03.24

3347

22

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1629

3

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.06.27

1211

7

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

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

2023.07.18

4867

5

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.10

2188

6

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

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

2023.07.18

4867

5

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.10

2188

6

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程