F5可直接启动插件调试，无需配置launch.json

想调试自己开发的VSCode插件？其实比想象中简单。直接按下F5，调试环境就能启动，完全不需要手动配置那个launch.json文件。VSCode在这方面做得相当贴心，插件开发调试基本上是开箱即用的。不过，这里有个关键前提：你打开的必须是插件项目的根目录，也就是包含package.json和src/extension.ts核心文件的那个文件夹，而不是随便一个子目录或不相干的文件夹。

为什么 F5 启动后看不到你的命令？

按下F5，新窗口弹出来了，但在命令面板里却搜不到自己写的命令？这通常是配置环节出了点小岔子，问题多半出在package.json里。

• 首先，contributes.commands这个字段必须正确定义。你得确保里面包含了你在代码中注册的那个命令ID（比如myExtension.sayHello），否则命令面板根本无从知晓它的存在。
• 其次，activationEvents（激活事件）的配置也至关重要。如果这里只写了["onCommand:myExtension.sayHello"]，那么插件只有在用户第一次执行这个特定命令时才会被激活。如果你想让它一启动就处于可用状态，可能需要考虑添加"*"这样的通配符，或者使用"onStartup"事件（注意后者需要VS Code 1.86及以上版本）。
• 最后，记住一个容易忽略的步骤：每次修改完package.json后，必须重载窗口（通过执行Developer: Reload Window命令）或者直接重启调试会话。否则，新的配置声明是不会生效的。

调试窗口里 console.log 不显示？

代码明明跑了，console.log却石沉大海，找不到输出？别急，这不是代码没执行，而是日志去了另一个地方。

• 在F5启动的那个「扩展开发主机」新窗口里，输出默认会发送到「Debug Console」面板，而不是我们熟悉的浏览器开发者工具控制台。想看console.log的内容，你得在那个新窗口里按Ctrl+Shift+P（Mac是Cmd+Shift+P），调出命令面板，然后输入Developer: Toggle Developer Tools打开开发者工具，再切换到Console标签页才能看到。
• 其实，对于插件调试，更推荐的做法是使用vscode.window.showInformationMessage()或者vscode.window.showErrorMessage()这类API来给用户即时反馈。它们弹出的通知清晰可见，能有效避免你纠结于日志到底输出到了哪个角落。
• 如果想用断点调试，请确保断点打在了src/extension.ts这类源文件里，并且所有操作（比如触发命令）都是在「扩展开发主机」窗口里进行的。记住，在你原本的主VS Code窗口里操作，是不会触发插件断点的。

修改 extension.ts 后要重新 F5 吗？

好消息是，大多数时候不需要。对于TypeScript项目，VSCode默认启用了文件监视模式（watch mode）。当你保存对extension.ts的修改后，系统会自动将其编译到out/目录下。但是，以下几种情况属于例外，需要你手动干预一下：

• 如果你新增了import语句，或者修改了package.json中诸如"permissions"（如"workspace"）这类权限字段，那么必须重载窗口才能生效。
• 如果改动涉及activationEvents激活事件，或者新增了contributes.menus这类UI扩展点，比较稳妥的做法是：在按下F5重新启动调试之前，先清空out/目录，并重新运行一次npm run compile（或者确保你的TypeScript编译任务正在运行）。
• 万一发现改动没有生效，别慌。先检查编辑器右下角有没有TypeScript编译错误的提示。如果没有，再打开「扩展开发主机」窗口的「Output」面板，在下拉菜单中选择「Extensions」频道，看看你的插件是否成功加载，以及有没有任何报错信息。

最后，分享一个最容易被开发者忽略的要点：你的插件核心逻辑虽然写在activate函数里，但如果你注册的是一个命令，那么该命令对应的回调函数里的代码，只有在用户真正执行这个命令时才会运行