VS Code扩展开发：如何获取编辑器中正则匹配的行号？

嘿，这个需求其实挺实用的，核心就是靠VS Code提供的文本API来把正则匹配的位置转换成行号，我给你梳理下具体的实现思路和关键步骤：

1. 先拿到当前活跃的编辑器和文档 #

首先得确保用户打开了某个文本文件，用vscode.window.activeTextEditor获取当前编辑器实例，再通过它拿到对应的TextDocument对象——这个对象里包含了文档的所有内容和位置转换的关键方法。

2. 执行正则匹配并捕获每个匹配的位置 #

用你指定的正则表达式（记得加g全局标志）对文档全文执行匹配，推荐用matchAll方法，它会返回每个匹配项的详细信息，包括匹配文本和该匹配在整个文档中的字符偏移量（index）——这是我们获取行号的关键依据。

3. 把偏移量转换成行号 #

VS Code的TextDocument有个超好用的方法positionAt(offset)，传入匹配项的index，就能得到一个Position对象，里面的line属性就是该匹配所在的行号（注意：VS Code内部行号从0开始，展示给用户的时候记得加1，变成大家习惯的从1开始的行号）。

4. 展示匹配项供用户选择 #

这里要纠正个小细节：window.showInputBox是让用户输入内容的，展示可选列表应该用window.showQuickPick更合适。我们可以把每个匹配的文本、行号组合成选项（比如"匹配内容 (行 5)"），让用户直观看到并选择。

5. 选中后跳转对应行 #

用户选中某个选项后，我们取出对应的Position，创建一个Range（范围），然后设置编辑器的选中区域并滚动到该位置，就能实现跳转效果了。

给你贴几段核心代码片段，方便你快速上手：

// 1. 获取当前编辑器和文档
const editor = vscode.window.activeTextEditor;
if (!editor) {
    vscode.window.showErrorMessage('请先打开一个文本编辑器哦');
    return;
}
const document = editor.document;
const fullText = document.getText();

// 2. 执行正则匹配（这里替换成你的正则表达式）
const targetRegex = new RegExp(/你的正则表达式/, 'g');
const allMatches = [...fullText.matchAll(targetRegex)];

// 3. 转换为带行号的选项
const pickOptions = allMatches.map(match => {
    const matchPosition = document.positionAt(match.index!);
    const displayLine = matchPosition.line + 1; // 转成1开始的行号
    return {
        label: `${match[0]} (行 ${displayLine})`,
        description: `列 ${matchPosition.character + 1}`,
        position: matchPosition // 存下位置，方便后续跳转
    };
});

// 4. 展示选择列表
const selectedItem = await vscode.window.showQuickPick(pickOptions, {
    placeHolder: '选择要跳转的匹配项'
});

// 5. 跳转到选中的行
if (selectedItem) {
    const targetRange = new vscode.Range(selectedItem.position, selectedItem.position);
    editor.selection = new vscode.Selection(targetRange.start, targetRange.end);
    editor.revealRange(targetRange, vscode.TextEditorRevealType.AtTop);
}

• 正则要加g全局标志，不然只会匹配第一个结果；
• 处理多行文本时，不用自己计算换行符，positionAt会自动帮你处理所有换行情况；
• 如果匹配项太多，可以考虑加个搜索过滤，showQuickPick支持用户输入过滤选项，非常方便。

内容的提问来源于stack exchange，提问作者Mokkapps