远程环境VSCode扩展：解析vscode-local协议为绝对路径的方法

开发者阿泽

2026-7-23

解析VSCode远程环境中"vscode-local"协议的绝对路径

在VSCode远程环境下处理showSaveDialog返回的vscode-local类型URI，不用自己手动解析路径，直接用VSCode内置API就能搞定：

方法1：直接用VSCode文件系统API写入（推荐）

VSCode的vscode.workspace.fs模块支持跨不同文件协议（包括vscode-local）的文件操作，不需要解析成本地绝对路径就能直接写入数据：

import * as vscode from 'vscode';
import { Buffer } from 'buffer';

async function saveDataToUri(uri: vscode.Uri, data: string) {
    // 将字符串转换为Uint8Array
    const buffer = Buffer.from(data, 'utf8');
    // 直接写入目标URI，自动处理vscode-local协议
    await vscode.workspace.fs.writeFile(uri, buffer);
}

这种方式最稳妥，VSCode会自动处理不同环境（远程/本地）的文件系统适配，不用关心底层路径转换逻辑。

方法2：转换为本地绝对路径（如果必须获取路径）

如果你的场景必须拿到本地绝对路径，可以用vscode.env.asExternalUri将vscode-local URI转换为本地可识别的绝对路径URI：

import * as vscode from 'vscode';

async function getLocalAbsolutePath(uri: vscode.Uri): Promise<string> {
    if (uri.scheme === 'vscode-local') {
        // 转换为外部可访问的URI
        const externalUri = await vscode.env.asExternalUri(uri);
        // 外部URI的fsPath就是本地绝对路径
        return externalUri.fsPath;
    }
    // 非vscode-local协议直接返回原fsPath
    return uri.fsPath;
}

调用这个方法后，就能拿到类似/mnt/c/Users/xxx/output.json的绝对路径，之后可以用Node.js的fs模块进行文件操作。