这种客户端和远程服务器共享代码但路径不一致的场景，VSCode 的 Language Client 完全支持双向路径转换，我给你整理了两种实际项目里常用的实现方案：

1. 客户端侧拦截请求/响应做路径转换 #

这是最直接的方式，在客户端初始化 Language Client 时，通过中间件拦截所有和路径相关的请求与响应，完成双向转换。

TypeScript 代码示例 #

import { LanguageClient, LanguageClientOptions, ServerOptions } from 'vscode-languageclient/node';

// 先定义好你的路径映射规则，键是客户端路径，值是服务器对应路径
const pathMappings = new Map([
    ['/home/username/myproject', '/mnt/shared_folder/myproject']
]);

// 客户端路径转服务器路径的工具函数
function clientToServerUri(uri: string): string {
    const clientPath = uri.replace('file://', '');
    for (const [clientRoot, serverRoot] of pathMappings) {
        if (clientPath.startsWith(clientRoot)) {
            return `file://${clientPath.replace(clientRoot, serverRoot)}`;
        }
    }
    return uri;
}

// 服务器路径转客户端路径的工具函数
function serverToClientUri(uri: string): string {
    const serverPath = uri.replace('file://', '');
    for (const [clientRoot, serverRoot] of pathMappings) {
        if (serverPath.startsWith(serverRoot)) {
            return `file://${serverPath.replace(serverRoot, clientRoot)}`;
        }
    }
    return uri;
}

// 配置 Language Client 选项
const clientOptions: LanguageClientOptions = {
    documentSelector: [{ scheme: 'file', language: '你的目标语言' }],
    // 用中间件拦截请求和响应
    middleware: {
        // 发送请求给服务器前，把客户端路径转成服务器能识别的路径
        sendRequest: (request, token, next) => {
            if (request.method.startsWith('textDocument/')) {
                if (request.params?.textDocument?.uri) {
                    request.params.textDocument.uri = clientToServerUri(request.params.textDocument.uri);
                }
            }
            return next(request, token);
        },
        // 接收服务器响应后，把服务器路径转成客户端本地路径
        receiveResponse: (response, method, next) => {
            // 处理那些返回路径的响应，比如定义、引用、悬停等
            if (method.endsWith('/definition') || method.endsWith('/references')) {
                if (Array.isArray(response)) {
                    response.forEach(item => {
                        if (item?.uri) item.uri = serverToClientUri(item.uri);
                    });
                } else if (response?.uri) {
                    response.uri = serverToClientUri(response.uri);
                }
            }
            return next(response, method);
        }
    }
};

// 配置远程服务器的启动选项
const serverOptions: ServerOptions = {
    command: '你的远程服务器启动命令',
    args: ['--root', '/mnt/shared_folder/myproject'] // 告诉服务器它的根路径
};

// 创建并启动客户端
const client = new LanguageClient(
    '你的语言服务标识',
    '你的语言服务名称',
    serverOptions,
    clientOptions
);
client.start();

2. 服务器侧接收客户端根路径做映射 #

如果更希望逻辑集中在服务器端，也可以让客户端把本地的工作区根路径传递给服务器，由服务器维护映射关系，处理双向转换。

服务器侧 TypeScript 示例 #

import { InitializeParams, InitializeResult, TextDocumentPositionParams } from 'vscode-languageserver/node';

let clientRootUri: string;
// 服务器这边的固定根路径
const serverRootUri = 'file:///mnt/shared_folder/myproject';

// 初始化时接收客户端传来的根路径
connection.onInitialize((params: InitializeParams): InitializeResult => {
    clientRootUri = params.rootUri || '';
    return {
        capabilities: {
            textDocumentSync: 1,
            definitionProvider: true // 根据你的服务能力调整
        }
    };
});

// 客户端路径转服务器路径
function clientToServerPath(clientUri: string): string {
    return clientUri.replace(clientRootUri, serverRootUri);
}

// 服务器路径转客户端路径
function serverToClientPath(serverUri: string): string {
    return serverUri.replace(serverRootUri, clientRootUri);
}

// 举个例子，处理定义查询请求时的路径转换
connection.onDefinition((params: TextDocumentPositionParams) => {
    // 先把客户端传来的URI转成服务器本地路径
    const serverUri = clientToServerPath(params.textDocument.uri);
    // 这里执行你的服务器逻辑，查找定义...
    // 找到结果后，再把服务器路径转回客户端路径
    return {
        uri: serverToClientPath('file:///mnt/shared_folder/myproject/src/index.ts'),
        range: { start: { line: 5, character: 0 }, end: { line: 5, character: 10 } }
    };
});

一些小提示 #

• 确保映射的根路径完全匹配，避免出现部分路径替换错误的情况
• 如果是多工作区场景，可以扩展映射表为多组键值对，逐个匹配
• 要是用的是VSCode Remote（比如容器、WSL），VSCode本身有内置路径转换，但自定义的Language Client还是需要手动处理这些逻辑

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