如何在VSCode API中获取未作为工作区打开的当前文件夹路径？

API 探路者

2026-6-26

解决VS Code扩展中单个文件夹模式下获取路径的问题

当VS Code仅打开单个文件夹而非工作区时，vscode.workspace.workspaceFolders会返回undefined，可以通过以下兼容方案获取当前文件夹路径：

优先兼容工作区模式：先判断workspaceFolders是否存在，存在则直接取第一个文件夹的路径
单个文件夹模式下从活动编辑器提取：如果用户当前打开了本地文件，可通过活动编辑器的文档URI获取其所在文件夹路径
回退手动选择：无活动文件时，弹出对话框让用户手动选择目标文件夹

代码示例

import * as vscode from 'vscode';
import * as path from 'path';

async function getCurrentFolderPath(): Promise<string | undefined> {
    // 工作区模式下直接取第一个文件夹路径
    if (vscode.workspace.workspaceFolders?.length) {
        return vscode.workspace.workspaceFolders[0].uri.fsPath;
    }

    // 单个文件夹模式下，从活动编辑器的文件提取父文件夹
    const activeEditor = vscode.window.activeTextEditor;
    if (activeEditor?.document.uri.scheme === 'file') {
        return path.dirname(activeEditor.document.uri.fsPath);
    }

    // 无活动文件时，让用户手动选择文件夹
    const selectedFolder = await vscode.window.showOpenDialog({
        canSelectFiles: false,
        canSelectFolders: true,
        canSelectMany: false,
        openLabel: '选择当前工作文件夹'
    });

    return selectedFolder?.[0].fsPath;
}