---
title: "LSP Client Orchestration"
type: concept
tags: [lsp, concurrency, architecture]
last_updated: 2026-04-20
---

## Definition
LSP Client Orchestration 是指并发管理多个语言服务器客户端的架构模式，使异构编程语言的代码智能在统一平台协同工作。

## Core Pattern
```typescript
class LSPOrchestrator {
  private clients = new Map<string, LanguageClient>();
  private capabilities = new Map<string, ServerCapabilities>();

  async initialize(projectRoot: string) {
    await Promise.all([
      this.initializeClient('typescript', tsClient),
      this.initializeClient('php', phpClient),
      this.initializeClient('go', goClient),
      this.initializeClient('rust', rustClient),
      this.initializeClient('python', pyrightClient)
    ]);
  }

  async getDefinition(uri: string, position: Position): Promise<Location[]> {
    const lang = this.detectLanguage(uri);
    const client = this.clients.get(lang);
    if (!client || !this.capabilities.get(lang)?.definitionProvider) {
      return [];
    }
    return client.sendRequest('textDocument/definition', { textDocument: { uri }, position });
  }
}
```

## Key Challenges
- 能力协商：不同语言服务器能力差异巨大，需动态检测
- 生命周期管理：每个客户端需独立经历 initialize → initialized → shutdown → exit
- 请求路由：根据文件扩展名路由到正确的语言服务器

## Connections
- [[LSP (Language Server Protocol)]] ← 基于 ← [[LSP Client Orchestration]]
- [[graphd]] ← 实现 ← [[LSP Client Orchestration]]