LSP是微软定义的编辑器与语言服务器通信标准，通过JSON-RPC实现代码补全、跳转定义等功能；开发者需编写语言服务器并集成至VSCode扩展，利用textDocument/completion、textDocument/definition等协议方法为语言启用智能感知，推荐使用vscode-languageserver-node或pygls工具包，注意协议兼容性与初始化流程。
智能感知功能，比如代码补全、跳转定义、悬停提示等，是现代编辑器提升开发效率的核心能力。VSCode 通过 语言服务器协议（Language Server Protocol, LSP）实现这些功能，使得编辑器与编程语言的语义分析能力解耦，让开发者可以在不同语言中获得一致的编码体验。
语言服务器协议（LSP）是什么？
LSP 是由微软提出的一种标准化通信协议，定义了编辑器（如 VSCode）与语言服务器之间的消息格式。语言服务器负责分析特定编程语言的语法和语义，而编辑器只负责界面展示和用户交互。两者通过 JSON-RPC 进行通信。
关键点：
- 编辑器发送文件内容变化、光标位置等请求
- 语言服务器返回补全项、错误诊断、定义位置等响应
- 协议支持方法如 textDocument/completion、textDocument/definition 等
如何为一种语言启用智能感知？
要在 VSCode 中为某语言实现智能感知，需提供一个符合 LSP 的语言服务器，并通过扩展将其集成。
步骤如下：
- 编写或使用现成的语言服务器（如 TypeScript 的 tsserver、Python 的 pylsp）
- 开发 VSCode 扩展，启动并管理该服务器进程
- 配置 serverOptions 和 clientOptions，注册 LanguageClient
- 确保服务器能处理文档同步、补全、hover 等请求
常见智能感知功能对应的 LSP 方法
每种功能背后都对应一个或多个 LSP 定义的标准方法：
- 代码补全：textDocument/completion
- 跳转到定义：textDocument/definition
- 查找引用：textDocument/references
- 悬停提示：textDocument/hover
- 错误标记：textDocument/publishDiagnostics
- 重命名符号：textDocument/rename
自定义语言服务器的实现建议
如果你正在为一门自研语言或 DSL 实现智能感知，推荐使用官方提供的 LSP SDK：
- Node.js 可用 vscode-languageserver-node
- Python 推荐 pygls（Python Generic Language Server）
- 核心逻辑包括解析源码生成 AST，维护符号表，实现类型推导等
- 注意性能优化，避免阻塞主线程，支持增量更新
基本上就这些。LSP 让 VSCode 成为支持上百种语言的通用编辑器，只要语言有对应的服务器，就能享受统一的智能编码体验。不复杂但容易忽略的是，协议版本兼容性和初始化流程的正确处理，往往决定功能是否稳定可用。
