LSP是VSCode与语言服务器间标准化的JSON-RPC通信协议，支持定义跳转、悬停提示、代码补全等智能功能，实现编辑器与语言逻辑解耦及跨编辑器复用。
VSCode 的语言服务器协议（LSP）是一种标准化的通信协议，用于在代码编辑器与语言服务器之间交换代码分析、补全、跳转、悬停提示等智能功能所需的数据。它使编辑器无需为每种编程语言单独实现语言特性，而是通过统一接口调用外部语言服务器。以下是关于 LSP 的核心说明：
本文运行环境：MacBook Air，macOS Sequoia。
一、LSP 的基本架构
LSP 定义了客户端（如 VSCode）与服务器（如 TypeScript Server、pylsp、rust-analyzer）之间的 JSON-RPC 消息格式和交互流程。客户端负责 UI 层操作，服务器专注语言逻辑处理，二者解耦运行。
1、客户端向服务器发送初始化请求（initialize），携带项目路径、支持能力等元信息。
2、服务器响应初始化结果，确认是否支持文档同步、语义高亮、代码格式化等功能。
3、用户在编辑器中执行操作（如输入、保存、悬停），客户端将事件封装为标准请求发送至服务器。
4、服务器执行分析后，返回结构化响应（如 TextEdit 数组用于自动补全、Location 对象用于定义跳转）。
二、LSP 的关键能力
LSP 规范明确定义了编辑器可向语言服务器查询的一组语义功能，每项功能对应特定请求类型，确保跨编辑器行为一致。
1、textDocument/definition：支持按住 Ctrl（或 Cmd）点击符号跳转到其定义位置。
2、textDocument/hover：鼠标悬停时显示类型签名、文档注释等信息。
3、textDocument/completion：触发代码补全，返回候选列表及详细文档说明。
4、textDocument/references：查找某符号在当前工作区中的所有引用位置。
5、textDocument/formatting：根据语言规范对选中代码块或整个文件进行格式化。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
三、VSCode 中 LSP 的启用机制
VSCode 本身不内置任何语言服务器，而是通过扩展系统加载符合 LSP 规范的服务器进程。扩展需声明 serverModule 或提供可执行路径，并由 VSCode 启动该进程并建立双向通信管道。
1、安装语言扩展（如 Python 扩展包）后，VSCode 在 extension host 进程中启动对应语言服务器子进程。
2、扩展通过 vscode-languageclient 模块封装 LSP 客户端逻辑，自动处理连接、消息序列化与错误重试。
3、当打开 .py 文件时，VSCode 将文件 URI、版本号、初始内容发送至 Python 语言服务器，触发语法树构建与语义分析。
4、服务器持续监听文件变更通知（didChange），并在后台增量更新符号表与诊断信息（diagnostics）。
四、LSP 与传统编辑器插件的区别
传统插件通常将语法解析、补全逻辑直接嵌入编辑器进程，导致资源占用高、语言支持碎片化；而 LSP 将语言智能下沉为独立服务，实现跨平台、跨编辑器复用。
1、同一 Rust 语言服务器（rust-analyzer）既可被 VSCode 调用，也可被 Vim、Neovim、GNOME Builder 等其他编辑器使用。
2、服务器进程崩溃不会导致 VSCode 主界面卡死，客户端可捕获 exit 信号并提示重启。
3、服务器可运行在远程机器上，VSCode 通过 stdio 或 socket 连接，实现远程开发场景下的本地编辑+远程分析。
五、LSP 的消息传输层
LSP 不限定底层传输方式，仅要求基于 JSON-RPC 2.0 协议。VSCode 默认采用标准输入输出流（stdio）进行进程间通信，亦支持通过 TCP Socket 或 WebSocket 建立连接。
1、VSCode 启动语言服务器时，设置环境变量 VSCODE_IPC_HOOK 和 --stdio 参数以指示通信方式。
2、所有请求与响应均以 Content-Length 头标识 JSON 体长度，避免粘包问题。
3、每个 JSON-RPC 消息必须包含 jsonrpc: "2.0"、id（请求唯一标识）、method（如 textDocument/completion）和 params 字段。
