nexus/wiki/concepts/LanguageServerProtocol.md at b40abbcd473a7093d8261e212e3d6de97c1e516a

ishenwei/nexus

Fork 0

Files

weishen 111bc65b7b Update nexus wiki content

2026-05-03 05:42:12 +08:00

2.3 KiB

Raw Blame History

title, type, tags, sources, last_updated

title

type

Definition

Language Server Protocol（LSP）是 Microsoft 在 2016 年首创的标准化协议，定义了语言服务器（Language Server）与语言客户端（Editor/IDE）之间的通信规范，使编程语言工具能够在任何编辑器中提供一致的代码智能功能（跳转定义、查找引用、悬停文档、自动完成等），无需为每个编辑器-语言组合单独实现。

Core Mechanism

Protocol Architecture

Language Server：独立进程，负责语言特定的代码分析（解析、类型检查、语义分析）
Language Client：编辑器/IDE 端，负责用户交互和结果展示
Communication：通过 JSON-RPC（2.0）在 stdin/stdout 之间传输消息

LSP 3.17 关键能力

textDocument/didOpen — 文档打开通知
textDocument/definition — 跳转到定义
textDocument/references — 查找引用
textDocument/hover — 悬停文档
textDocument/completion — 自动完成
textDocument/publishDiagnostics — 诊断信息发布
workspace/symbol — 工作区符号搜索

Capability Negotiation

客户端在 initialize 请求中声明自身能力：

{
  "capabilities": {
    "textDocumentSync": 1,
    "definitionProvider": true,
    "referencesProvider": true,
    "hoverProvider": true
  }
}

服务器在响应中声明支持的能力。LSP/Index Engineer 强制要求永远检查服务器能力响应，而非假设支持某功能。

Lifecycle

initialize → initialized → （正常运行）→ shutdown → exit

Multi-Language Orchestration

LSP 的核心价值在于使多语言支持标准化。LSP/Index Engineer 的 graphd 通过协调多个语言服务器（TypeScript、PHP、Go、Rust、Python），将各自 LSP 响应统一转换为语义图谱，实现跨语言的代码导航。

Connections

LanguageServerProtocol ← enables ← LSPOrchestrator
LanguageServerProtocol ← powers ← SemanticCodeGraph
LSPOrchestrator ← coordinates ← TypeScriptLanguageServer
LSPOrchestrator ← coordinates ← Intelephense
LanguageServerProtocol ← uses ← LSIF

2.3 KiB Raw Blame History Unescape Escape