首先需导入vscode模块，通过activate函数注册命令、操作编辑器内容并监听事件。例如，使用vscode.commands.registerCommand注册命令，vscode.window.activeTextEditor修改文本，vscode.workspace.onDidSaveTextDocument监听文件保存事件，所有订阅均应加入context.subscriptions以确保正确释放资源。
要在 Visual Studio Code 中为自定义扩展添加功能，你需要使用 VSCode 提供的官方扩展 API（通过 vscode 模块）。这些 API 允许你与编辑器交互，比如操作文本、控制 UI、响应用户命令等。下面介绍如何实际利用这些 API 来增强你的扩展。
理解 vscode API 的基本结构
VSCode 扩展是用 TypeScript 或 JavaScript 编写的，通过激活函数（activate）入口与编辑器集成。API 主要通过以下方式暴露：
- vscode.commands：注册和调用命令
- vscode.window：操作编辑器窗口、显示消息、创建输入框
- vscode.workspace：访问工作区文件、配置、事件
- vscode.languages：实现语法高亮、补全、诊断等功能
- vscode.extensions：查询其他扩展状态
这些对象在扩展的主文件（通常是 extension.ts 或 extension.js）中导入：
import * as vscode from 'vscode';
注册命令并响应用户操作
大多数扩展都从注册一个命令开始。用户可通过命令面板或快捷键触发该命令。
在 activate 函数中使用 vscode.commands.registerCommand：
export function activate(context: vscode.ExtensionContext) {
const disposable = vscode.commands.registerCommand('myExtension.sayHello', () => {
vscode.window.showInformationMessage('Hello from my extension!');
});
context.subscriptions.push(disposable);
}
这个命令会在用户执行 myExtension.sayHello 时弹出提示。记得将命令注册到 context.subscriptions，以便在扩展停用时自动清理。
操作编辑器内容
你可以通过 vscode.window.activeTextEditor 获取当前编辑器，并修改文档内容。
例如，插入当前时间：
vscode.commands.registerCommand('myExtension.insertTime', () => {
const editor = vscode.window.activeTextEditor;
if (editor) {
const now = new Date().toLocaleTimeString();
editor.edit(editBuilder => {
editBuilder.insert(editor.selection.active, now);
});
}
});这里使用了 edit 方法确保更改被正确记录，支持撤销操作。
监听事件并做出响应
VSCode API 支持多种事件监听，如文件保存、编辑器切换、配置更改等。
例如，在每次保存文件时打印消息：
vscode.workspace.onDidSaveTextDocument((doc) => {
vscode.window.showInformationMessage(`Saved: ${doc.fileName}`);
});将返回的事件订阅加入 context.subscriptions 可避免内存泄漏。
基本上就这些。掌握核心 API 后，你可以构建出从简单工具到复杂语言服务的各种功能。关键是查阅官方文档，理解每个模块的能力边界。
