VSCode如何调试和测试插件_VSCode插件调试与测试详解
VSCode插件调试必须使用Extension Development Host模式 调试VSCode插件，有个关键点必须牢记：它和普通的Node.js程序不一样，不能直接挂载调试器。唯一的正解，是走Extension Development Host模式。为什么？因为只有这个模式，才能正确触发插件
VSCode插件调试必须使用Extension Development Host模式
调试VSCode插件，有个关键点必须牢记：它和普通的Node.js程序不一样，不能直接挂载调试器。唯一的正解，是走Extension Development Host模式。为什么？因为只有这个模式，才能正确触发插件的activate函数，并加载package.json里定义的contributes和activationEvents。换句话说，这是插件“活”起来的唯一路径。
为什么F5启动后插件没反应？
这个问题太常见了：点击调试按钮，新的VSCode窗口（Extension Development Host）弹出来了，但你的插件命令死活不出现，断点也打不中，连console.log都石沉大海。
其实，根本原因往往不是代码写错了，而是激活事件没被触发。举个例子，如果你的插件注册了一个“onCommand:hello-world.sayHello”激活事件，但你在新窗口里没有手动去执行这个命令，那么activate函数压根就不会完整运行。
- 检查
launch.json：里面的request必须是“launch”，type必须是“extensionHost”。如果错用成“node”类型，启动的只是一个孤立的Node进程，根本加载不了插件上下文。 - 确认项目配置：确保项目根目录有有效的
package.json，其中的main字段指向正确的入口文件（比如./out/extension.js），并且out目录已经由TypeScript编译生成。
如何让断点真正生效？
想让断点起作用，得打在正确的地方。最可靠的位置是activate函数内部，但前提是它得被调用。打在命令的回调函数里也行，不过你得先在Extension Development Host窗口里，通过Ctrl+Shift+P输入命令名来触发它。
- TypeScript源码断点依赖
sourceMap：务必确认tsconfig.json中的sourceMap设为true，并且编译后，.js文件旁边得有对应的.js.map文件。 - 别在
deactivate里设断点并指望它自动触发——这个函数只在插件卸载时调用，而VSCode默认不会自动卸载你正在调试的插件。 - 如果断点变灰了（显示unbound），先检查
out目录是不是被.gitignore排除了，导致调试器找不到映射文件。或者，看看launch.json里的outFiles路径是否正确，通常应该包含“${workspaceFolder}/out/**/*.js”。
测试插件逻辑要不要写单元测试？
当然要写，但方法有讲究。千万别直接用Jest或Vitest去import你的extension.ts——因为VSCode API（比如vscode.window、vscode.workspace）在非Extension Host环境下是undefined，一跑就报错。
- 官方推荐方案是
@vscode/test-electron：这个工具会启动一个最小化的Electron实例，并注入模拟的VSCode API，让你能真实地测试命令注册、配置读取这些行为。 - 对于简单的纯工具函数（不依赖VSCode API的部分），可以抽离到独立模块，然后用Jest单独测试，这部分不需要mock。
- 集成测试（比如验证执行命令后是否会弹出消息框）必须走
@vscode/test-electron这条路。你需要在test/runTest.ts中调用runTests，并传入extensionDevelopmentPath和extensionTestsPath参数。
调试失败时优先检查这三处
很多时候，问题出在环境链路的断裂上，而不是代码逻辑本身。遇到麻烦，先看看这三个地方：
package.json的activationEvents：如果你写的是“onCommand:xxx”这类具体事件（而不是“*”），就必须在Dev Host窗口里执行对应的命令来激活插件，否则插件永远处于“休眠”状态。tsconfig.json的路径配置：检查outDir和rootDir是否配置正确。如果编译输出路径和launch.json里outFiles的路径不匹配，sourceMap就会失效，断点自然失灵。- TypeScript装饰器支持：如果你用了TypeScript 5.4的装饰器语法，务必确认
tsconfig.json里开启了experimentalDecorators和emitDecoratorMetadata。否则，编译后装饰器信息会丢失，导致插件注册失败。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
