如何让VSCode虚拟文档标签显示自定义文件夹名称？

AI 小北

2026-7-19

让VSCode虚拟文档标签显示区分性文件夹名的方法

VSCode对常规文件的标签区分逻辑依赖真实路径层级，但虚拟文档默认不会触发该逻辑，你可以通过以下两种方法解决：

方法一：确保虚拟文档Uri的路径层级完整

创建虚拟文档时（无论是通过workspace.openTextDocument还是自定义TextDocumentContentProvider），必须传入包含完整多级结构的Uri，比如你提到的sql/FJ5G91KN/queries.sql和sql/6D3B7G5K/queries.sql。注意：

自定义TextDocumentContentProvider时，不要把虚拟路径扁平化，必须保留多级结构

用vscode.Uri.parse构造Uri时，路径部分要严格对应层级，示例代码：

const uri1 = vscode.Uri.parse('vscode-your-extension://sql/FJ5G91KN/queries.sql');
const uri2 = vscode.Uri.parse('vscode-your-extension://sql/6D3B7G5K/queries.sql');

方法二：注册自定义标签标题格式化器

如果默认路径识别仍不生效，可以通过window.registerTabTitleFormatter手动控制标签显示内容：

vscode.window.registerTabTitleFormatter({
  formatTabTitle: (tab) => {
    if (tab.input instanceof vscode.TabInputText) {
      const uri = tab.input.uri;
      // 仅处理你的扩展的虚拟文档协议
      if (uri.scheme === 'vscode-your-extension') {
        const pathSegments = uri.path.split('/');
        // 提取倒数第二级文件夹名作为区分标识
        if (pathSegments.length >= 2) {
          const folderName = pathSegments[pathSegments.length - 2];
          return `${pathSegments[pathSegments.length - 1]} (${folderName})`;
        }
      }
    }
    // 非目标文档返回默认标题
    return undefined;
  }
});

这个方法能完全自定义标签显示格式，适配任意虚拟文档路径结构。