0

0

如何调试VSCode扩展本身?

夜晨

夜晨

发布时间:2025-10-02 10:04:02

|

661人浏览过

|

来源于php中文网

原创

调试 VSCode 扩展需先安装 VSCode、Node.js 和 vsce 工具,并用 yo code 生成项目,其中 .vscode/launch.json 配置了名为 "Extension" 的调试任务,类型为 extensionHost,启动时会加载当前扩展到新窗口(标有 “[Extension Development Host]”),在该窗口中可测试命令或触发事件,原始编辑器中的断点将生效;若断点未命中需检查编译输出路径 outFiles 及 TypeScript 编译状态,推荐使用 tsc -w 监听文件变化并重启调试会话以应用更改,还可通过添加 console: "integratedTerminal" 查看日志,整体依赖扩展宿主机制实现进程隔离与调试连接。

如何调试vscode扩展本身?

调试 VSCode 扩展本身其实非常直接,VSCode 提供了内置的支持来让你在开发过程中快速测试和调试自己的扩展。以下是具体操作步骤和关键点。

1. 准备调试环境

确保你已经:

  • 安装了 Visual Studio Code
  • 安装了 Node.js(推荐 LTS 版本)
  • 全局安装了 vsce(VSCode 扩展打包工具):npm install -g vsce
  • yo code 生成了一个扩展项目(需要先安装 Yeoman)

生成的项目中会包含 .vscode/launch.json 和 package.json,这些是调试的关键配置文件

2. 使用默认启动配置

打开你的扩展项目,在 .vscode/launch.json 中应该能看到一个名为 "Extension" 的调试配置,它长这样:

{
  "name": "Extension",
  "type": "extensionHost",
  "request": "launch",
  "runtimeExecutable": "${execPath}",
  "args": [
    "--extensionDevelopmentPath=${workspaceFolder}"
  ],
  "outFiles": [
    "${workspaceFolder}/out/**/*.js"
  ]
}

这个配置的意思是:启动一个新的 VSCode 实例(称为“扩展宿主”),并加载当前项目作为正在开发的扩展。

点击调试侧边栏中的“运行”按钮,VSCode 会:

Vuex参考手册 中文CHM版
Vuex参考手册 中文CHM版

Vuex是一个专门为Vue.js应用设计的状态管理模型 + 库。它为应用内的所有组件提供集中式存储服务,其中的规则确保状态只能按预期方式变更。它可以与 Vue 官方开发工具扩展(devtools extension) 集成,提供高级特征,比如 零配置时空旅行般(基于时间轴)调试,以及状态快照 导出/导入。本文给大家带来Vuex参考手册,需要的朋友们可以过来看看!

下载
  • 编译你的 TypeScript(如果有)
  • 启动一个新窗口(标题通常带有 “[Extension Development Host]”)
  • 在这个窗口中激活你的扩展

3. 在开发窗口中测试功能

新打开的窗口就是你的“测试环境”。你可以像正常使用一样操作命令、触发事件等。

例如,如果你注册了一个命令 command:hello.world,可以在命令面板(Ctrl+Shift+P)里执行它。

此时,你在原始代码中设置的断点会被触发,可以查看变量、调用、单步执行等。

4. 调试技巧和常见问题

  • 确保 outFiles 指向正确的编译输出路径(如 out/**/*.js)
  • 如果断点显示为灰色,说明未命中,检查是否代码被正确编译和加载
  • 修改代码后,需要重新编译(或开启 tsc -w 监听)再重启调试会话
  • 可在 launch.json 中添加 console: "integratedTerminal" 查看后台输出
  • 使用 debug console 可以执行表达式、调用 API

基本上就这些。只要项目结构正确,VSCode 的调试体验很流畅。关键是理解“扩展宿主”机制:你的代码在一个独立进程中运行,而调试器连接的是那个进程。

相关专题

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

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

403

2023.08.07

json是什么
json是什么

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

528

2023.08.23

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

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

306

2023.10.13

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

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

74

2025.09.10

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

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

370

2023.07.18

堆和栈区别
堆和栈区别

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

563

2023.08.10

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

508

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

241

2023.07.28

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

61

2025.12.31

热门下载

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

精品课程

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

共21课时 | 2.3万人学习

Django 教程
Django 教程

共28课时 | 2.6万人学习

HTML教程
HTML教程

共500课时 | 4.3万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号