通过调用 vscode.executeDocumentSymbolProvider 获取文档符号，再筛选出包含当前光标位置的函数符号，即可准确获得光标所在的最外层函数名。
通过调用 `vscode.executedocumentsymbolprovider` 获取文档符号，再筛选出包含当前光标位置的函数符号，即可准确获得光标所在的最外层函数名。
在 VS Code 扩展开发中，常需根据用户光标位置动态获取上下文信息。例如，实现“跳转到当前函数定义”、“显示函数签名提示”或“生成函数级代码摘要”等功能时，首要步骤就是识别光标当前所处的函数作用域。
VS Code 并未提供直接的 getFunctionAtCursor() API，但可通过文档符号（Document Symbols）间接实现。vscode.executeDocumentSymbolProvider 命令返回当前文件中所有顶层符号（如类、函数、变量等），其结构为扁平化数组（注意：自 VS Code 1.86+ 起，executeDocumentSymbolProvider 返回的是 DocumentSymbol[] 数组，而非旧版的嵌套对象；Object.values(symbols) 已不适用，需直接遍历数组）。
✅ 正确实现方式如下：
import * as vscode from 'vscode';
export async function getCurrentFunctionName(
document: vscode.TextDocument,
position: vscode.Position
): Promise<string undefined> {
const symbols = await vscode.commands.executeCommand<vscode.documentsymbol>(
'vscode.executeDocumentSymbolProvider',
document.uri
);
if (!symbols) return undefined;
// 递归查找包含 position 的函数符号（支持嵌套函数的粗略匹配）
const findFunctionSymbol = (syms: vscode.DocumentSymbol[]): vscode.DocumentSymbol | undefined => {
for (const sym of syms) {
// 优先匹配函数/方法类型
if (
sym.kind === vscode.SymbolKind.Function ||
sym.kind === vscode.SymbolKind.Method
) {
if (sym.range.contains(position)) {
return sym;
}
}
// 深度优先递归子节点（处理嵌套函数，如 JS/TS 中的函数内声明）
if (sym.children && sym.children.length > 0) {
const nested = findFunctionSymbol(sym.children);
if (nested) return nested;
}
}
return undefined;
};
const targetSymbol = findFunctionSymbol(symbols);
return targetSymbol?.name;
}</vscode.documentsymbol></string>
? 使用示例（在命令处理器中）：
vscode.commands.registerCommand('extension.getCurrentFunction', async () => {
const editor = vscode.window.activeTextEditor;
if (!editor) return;
const name = await getCurrentFunctionName(editor.document, editor.selection.active);
if (name) {
vscode.window.showInformationMessage(`当前函数：${name}`);
} else {
vscode.window.showInformationMessage('光标未位于任何函数内');
}
});
⚠️ 注意事项：
- 文档符号依赖语言服务器支持：确保当前文件类型（如
.ts,.js,.py）已启用对应语言服务，且符号提供者已正确注册； - 性能考虑：该操作为异步且可能触发语言服务器查询，避免在高频事件（如
onDidChangeTextEditorSelection）中无节制调用，建议加防抖或缓存； - 局限性：标准 Document Symbol 不保证 100% 覆盖所有运行时可调用函数（如动态生成函数、IIFE 内匿名函数），对嵌套深度过大的场景，建议结合 AST 解析（如 TypeScript Compiler API 或
@babel/parser）提升精度。
总结：利用 vscode.executeDocumentSymbolProvider + 递归范围匹配，是轻量、可靠且跨语言（只要语言支持符号提供）的获取当前函数名方案。掌握此模式，可为各类智能编码辅助功能奠定关键上下文基础。
