如何开发你的第一个VSCode插件

开发首个vscode插件只需javaScript/typescript基础和node.js环境，核心是理解结构、激活时机与命令注册；通过yo code生成脚手架，配置package.json和extension.ts，用F5调试，最后用vsce打包发布。

开发你的第一个 VSCode 插件并不需要高深的前端功底，只要你会写 javascript（或 TypeScript），了解基本 Node.js 环境，就能快速上手。核心是理解插件的结构、激活时机和命令注册机制。

准备开发环境

确保本地已安装：

• node.js（建议 v16+）
• VSCode（最新稳定版）
• Yeoman + VS Code Extension Generator（用于快速生成脚手架）

执行以下命令安装脚手架工具：

npm install -g yo generator-code

然后运行 yo code，按提示选择“New Extension (TypeScript)”或“New Extension (JavaScript)”，填写插件名、ID、描述等信息，自动生成项目结构。

理解核心文件：package.json 和 extension.ts

package.json 是插件的“身份证”，定义了插件元信息、贡献点（contributes）和激活事件（activationEvents）。比如想让插件在用户打开命令面板时就加载，可设：
“activationEvents”: [“onCommand:extension.sayHello”]

extension.ts（或 extension.js）是主入口，导出 activate 和 deactivate 函数。activate 在插件被激活时调用，通常在这里注册命令：

制作简单的响应式幻灯片

本站介绍了很多 jQuery 幻灯片插件，它们都很优秀，且功能强大，应用在中大型页面上很合适。但如果你的页面很简单，只想要一个简单纯粹的幻灯片效果，这些插件可能略显臃肿。今天我们不用任何插件，写一个简单的响应式幻灯片。

88

查看详情

vscode.commands.registerCommand(‘extension.sayHello’, () => {
  vscode.window.showInformationMessage(‘Hello from my first extension!’);
});

运行与调试你的插件

打开生成的项目文件夹，在 VSCode 中按 Ctrl+Shift+P（windows/linux）或 Cmd+Shift+P（macos），输入并选择 “Developer: Toggle Developer Tools” 查看控制台报错；更推荐直接按 F5 启动调试——VSCode 会自动拉起一个“扩展开发主机”窗口，在其中测试你的插件，所有断点、日志、弹窗都可实时观察。

每次修改代码后，保存即可热重载（部分改动仍需重启开发主机）。

发布前的必要步骤

本地验证通过后，可打包为 .vsix 文件供他人安装：

• 全局安装 vsce：npm install -g vsce
• 登录 visual studio Marketplace（需 microsoft 账户）：vsce login
• 打包：vsce package → 生成 my-extension-0.0.1.vsix
• 发布（首次需创建 publisher）：vsce publish

发布后，别人就能在 VSCode 扩展市场中搜索名称安装了。

基本上就这些。不复杂但容易忽略细节，比如 activationEvents 写错会导致插件不加载，package.json 的 main 字段路径不对会报错“Cannot find module”。边写边查官方文档，比死磕更高效。