如何在VSCode扩展代码中访问预定义变量参考中的变量？

VSCode并没有直接暴露文档里那些预定义变量的全局访问入口，但你可以通过以下几种方式实现解析和使用：

1. 手动映射替换常用变量 #

对于大部分常用的预定义变量，你可以直接通过VSCode的现有API获取对应值，然后做字符串替换。这种方式不需要依赖内部服务，简单直接：

import * as vscode from 'vscode';

async function resolveVars(input: string): Promise<string> {
    // 先解析系统环境变量
    let output = vscode.env.resolveEnvironmentVariables(input);
    
    // 处理工作区相关变量
    const primaryWorkspace = vscode.workspace.workspaceFolders?.[0];
    if (primaryWorkspace) {
        output = output.replace(/\${workspaceFolder}/g, primaryWorkspace.uri.fsPath);
        output = output.replace(/\${workspaceFolderBasename}/g, primaryWorkspace.name);
    }
    
    // 处理当前文件相关变量
    const activeEditor = vscode.window.activeTextEditor;
    if (activeEditor) {
        const doc = activeEditor.document;
        output = output.replace(/\${file}/g, doc.uri.fsPath);
        output = output.replace(/\${fileBasename}/g, doc.fileName.split(/[\\/]/).pop() || '');
        output = output.replace(/\${fileDirname}/g, doc.uri.path.replace(/\/[^\/]+$/, ''));
    }
    
    // 按需添加更多变量替换，比如${lineNumber}、${selectedText}等
    return output;
}

// 调用示例
resolveVars('${workspaceFolder}/src/${fileBasename}').then(res => console.log(res));

2. 利用VSCode内置的配置解析能力 #

如果你是从扩展配置里读取包含预定义变量的字符串，VSCode会自动帮你解析这些变量。比如在你的package.json里定义配置项：

"contributes": {
    "configuration": {
        "title": "My Extension",
        "properties": {
            "myExtension.outputPath": {
                "type": "string",
                "default": "${workspaceFolder}/dist"
            }
        }
    }
}

然后在扩展代码里直接获取，拿到的就是解析后的路径：

import * as vscode from 'vscode';

const config = vscode.workspace.getConfiguration('myExtension');
const outputPath = config.get<string>('outputPath'); // 自动解析为当前工作区的dist目录路径

3. 调用VSCode内部变量解析服务（进阶） #

如果你需要覆盖所有预定义变量，包括一些更复杂的（比如${config:xxx}），可以通过VSCode的内部服务来实现。不过这种方法依赖VSCode的内部API，可能会在版本更新时变动，需要谨慎使用：

import * as vscode from 'vscode';

async function resolveAllVars(input: string): Promise<string> {
    const resolver = vscode.workspace.getConfiguration().inspect('')?.resolver;
    if (resolver) {
        return resolver.resolve(input, vscode.ConfigurationTarget.Global, undefined);
    }
    // 降级处理
    return resolveVars(input);
}

注意点 #

• 涉及当前文件、光标位置的变量（比如${lineNumber}、${selectedText}），必须确保有激活的编辑器窗口，否则无法获取对应值。
• 多工作区场景下，要注意workspaceFolders是数组，需要根据需求选择对应的工作区进行变量替换。

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