实现快速修复需注册CodeActionProvider，监听诊断问题并返回CodeAction，支持TextEdit或WorkspaceEdit。
在 VSCode 中开发“快速修复”功能，本质是实现一个 代码操作（Code Action）提供者，用于响应用户在编辑器中遇到的问题并提供自动修复建议。这通常配合语言服务器（Language Server）使用，也可以直接在普通扩展中实现。
理解快速修复机制
VSCode 的“快速修复”（Quick Fix）功能通过灯泡图标提示用户可执行的操作，比如修复语法错误、导入缺失模块、转换代码格式等。要实现这个功能，你需要注册一个 CodeActionProvider。
关键点：
- 监听特定诊断问题（由 Diagnostics 提供）
- 返回带有修复动作的 CodeAction 对象
- 支持编辑（TextEdit）、命令（Command）或工作区编辑（WorkspaceEdit）
注册快速修复提供者
在扩展的 activationEvents 中触发，并在 activate 函数中注册提供者：
// extension.ts import * as vscode from 'vscode';export function activate(context: vscode.ExtensionContext) { const provider = new MyQuickFixProvider(); context.subscriptions.push( vscode.languages.registerCodeActionsProvider('javascript', provider, { providedCodeActionKinds: [vscode.CodeActionKind.QuickFix] }) ); }
MyQuickFixProvider 需要实现 provideCodeActions 方法：
class MyQuickFixProvider implements vscode.CodeActionProvider {
provideCodeActions(
document: vscode.TextDocument,
range: vscode.Range | vscode.Selection,
context: vscode.CodeActionContext,
token: vscode.CancellationToken
): vscode.CodeAction[] {
// 只对包含诊断的问题行响应
const diagnostics = context.diagnostics;
const actions: vscode.CodeAction[] = [];
for (const diagnostic of diagnostics) {
if (diagnostic.message.includes('missing import')) {
const fix = new vscode.CodeAction(
'自动导入模块',
vscode.CodeActionKind.QuickFix
);
fix.edit = new vscode.WorkspaceEdit();
fix.edit.insert(
document.uri,
diagnostic.range.start.translate({ lineDelta: 0, characterDelta: 0 }),
"import { X } from 'module';\n"
);
actions.push(fix);
}
}
return actions;}
}
结合语言服务器使用（推荐）
如果你正在开发语言服务器（通过 vscode-languageserver），可以在服务端检测问题并发送诊断信息，然后在客户端扩展中响应这些诊断来提供修复。
服务端示例（发送诊断）：
connection.onDidOpenTextDocument((params) => {
const diagnostics: Diagnostic[] = [];
// 检查内容是否缺少导入
if (text.includes('X') && !text.includes('import')) {
diagnostics.push({
severity: DiagnosticSeverity.Warning,
message: 'missing import for X',
range: Range.create(0, 0, 0, 0),
code: 'missing-import'
});
}
connection.sendDiagnostics({ uri: params.textDocument.uri, diagnostics });
});
客户端则根据 diagnostic.code 判断是否提供对应修复。
测试与调试技巧
确保你的扩展能正确触发快速修复：
- 在 package.json 中声明正确的语言和激活事件
- 使用 console.log 或调试器检查 provideCodeActions 是否被调用
- 手动触发 Ctrl + . 查看灯泡菜单是否出现建议
- 确认诊断信息确实由你的扩展或语言服务器发出
基本上就这些。实现一个实用的快速修复功能，核心在于精准匹配诊断问题并构造安全的编辑操作。
