使用 VSCode 扩展 API 需先安装 Node.js 和 yo generator-code，通过 yo code 创建项目；核心是 package.json 中的 activationEvents 和 contributes 配置，以及 extension.ts 中的 activate 函数；常用操作包括注册命令、编辑文本、监听事件；调试时按 F5 启动扩展主机，发布前需用 vsce 工具打包并登录发布；关键在于正确设置激活事件与权限声明。
使用 VSCode 的扩展 API 主要是通过编写插件（即扩展）来增强编辑器功能。你需要用 TypeScript 或 JavaScript 编写代码，并利用 VSCode 提供的 vscode 模块来访问编辑器的功能，比如操作文本、添加命令、创建侧边栏、监听事件等。
1. 准备开发环境
确保你已安装：
- Node.js（推荐 LTS 版本）
- VSCode
- Yeoman 和 VS Code Extension Generator：
npm install -g yo generator-code
运行 yo code 创建一个新的扩展项目，选择 TypeScript 或 JavaScript 模板。
2. 理解核心结构：package.json 与 extension.ts
每个扩展都有一个 package.json 文件，其中定义了激活事件、贡献点和命令等信息。关键字段包括：
- activationEvents：指定何时激活扩展，例如 onCommand:myExtension.helloWorld
- contributes：定义菜单、按钮、配置项等 UI 贡献
主逻辑在 extension.ts（或 .js）中的 activate 函数执行。这是入口点。
3. 常用 API 示例
在 extension.ts 中导入 vscode 模块：
import * as vscode from 'vscode';
常见操作示例：
-
注册命令：
vscode.commands.registerCommand('myExtension.helloWorld', () => {
vscode.window.showInformationMessage('Hello World!');
}); -
操作当前编辑器内容：
const editor = vscode.window.activeTextEditor;
if (editor) {
editor.edit(editBuilder => {
editBuilder.insert(editor.selection.start, "Hello");
});
} -
监听事件（如文件保存）：
vscode.workspace.onDidSaveTextDocument((doc) => {
console.log('Saved:', doc.fileName);
});
4. 调试与发布
按 F5 启动调试，VSCode 会打开一个“扩展开发主机”窗口，在其中测试你的功能。
确认无误后，使用 VSCE 工具打包并发布：
- 安装： npm install -g @vscode/vsce
- 登录并发布： vsce publish
基本上就这些。掌握 activate 函数、命令注册和常用对象（如 window、workspace、commands）就能实现大多数功能。官方文档提供了完整的 API 参考，适合边查边写。不复杂但容易忽略细节，比如权限声明或激活事件设置不当会导致扩展无法启动。
