LSP管理Skill lsp-management

---

名称: lsp-management 描述: 为 Claude Code 中的 Language Server Protocol 提供 LSP 服务器推荐、.lsp.json 配置、安装指南和故障排除 允许工具: 读取、全局匹配、搜索、技能 用户可调用: false

LSP 管理技能

🚨 强制要求：首先调用 docs-management

停止 - 在提供任何关于 LSP 配置的响应之前：

1. 调用 docs-management 技能获取 Claude Code LSP 官方文档
2. 查询 用户特定的 LSP 主题
3. 基于 官方文档 + 本技能的知识库构建所有响应

跳过此步骤将导致信息过时或不正确。

⚠️ 实验性：Claude Code LSP 状态

Claude Code 中的 LSP 支持是实验性的，存在已知问题。 关键点：

要求	详情
环境变量	需要 ENABLE_LSP_TOOL=1（单数）以暴露 LSP 工具
当前版本	v2.1.0+ 具有部分支持（回归问题 #17468）
稳定版本	v2.0.67 是最后一个已知的稳定 LSP 版本
配置	项目根目录中的 .lsp.json 或 plugin.json 中的 lspServers

有关版本特定问题和解决方案，请参见 troubleshooting.md。

概述

Claude Code 中 Language Server Protocol (LSP) 配置的中央权威。本技能提供：

• 按语言/技术的 LSP 服务器推荐
• .lsp.json 文件的配置模式
• 每个推荐服务器的安装指南
• 常见 LSP 问题的故障排除

架构： 关键字注册表 + 策划知识库。委托给 docs-management 获取 Claude Code LSP 官方文档。

何时使用此技能

关键词： LSP, 语言服务器, language-server-protocol, 代码智能, hover, go-to-definition, find-references, diagnostics, pyright, typescript-language-server, gopls, rust-analyzer, csharp-ls, .lsp.json, LSP 配置, LSP 设置, LSP 故障排除

在以下情况使用此技能：

• 为项目设置 LSP 服务器
• 为语言选择 LSP 服务器选项
• 配置 .lsp.json 文件
• 故障排除 LSP 问题（hover 不工作、诊断缺失等）
• 了解 LSP 服务器安装要求
• 基于项目文件类型自动检测所需 LSP

docs-management 查询的关键字注册表

查询 docs-management 技能获取官方文档时使用这些关键字：

核心概念

主题	关键字
LSP 概述	“LSP”, “language server protocol”, “code intelligence”
配置文件	“.lsp.json”, “LSP configuration”, “language server config”
功能	“hover”, “go-to-definition”, “find-references”, “diagnostics”, “document symbols”

服务器特定

主题	关键字
Python	“pyright”, “pylsp”, “python language server”
TypeScript/JavaScript	“typescript-language-server”, “vtsls”, “tsserver”
Go	“gopls”, “go language server”
Rust	“rust-analyzer”, “rust language server”
C#	“csharp-ls”, “OmniSharp”, “C# language server”
C/C++	“clangd”, “ccls”, “C++ language server”

故障排除

主题	关键字
服务器问题	“LSP not working”, “language server crash”, “LSP restart”
功能问题	“hover not working”, “diagnostics missing”, “go-to-definition failing”
配置问题	“LSP config invalid”, “.lsp.json error”, “extension mapping”

快速决策树

你需要什么？

1. 为新项目设置 LSP → 参见 server-database.md 获取推荐服务器
2. 配置 .lsp.json → 参见 configuration-patterns.md 获取模式
3. 安装特定 LSP 服务器 → 参见 installation-guide.md 获取每服务器命令
4. 修复 LSP 问题 → 参见 troubleshooting.md 获取常见问题
5. 了解 Claude Code LSP 支持 → 查询 docs-management：“LSP configuration Claude Code”

LSP 服务器推荐（快速参考）

语言	推荐服务器	原因
Python	Pyright	快速、准确的类型检查，广泛的生态系统支持
TypeScript/JavaScript	typescript-language-server	官方 TypeScript 支持，广泛使用
Go	gopls	官方 Go 团队服务器，全面
Rust	rust-analyzer	事实标准，优秀性能
C#	csharp-ls	轻量级、跨平台、dotnet 工具
C/C++	clangd	LLVM 支持、快速、准确
Java	Eclipse JDTLS	功能齐全、广泛支持
Ruby	solargraph	类型推断、文档支持
PHP	intelephense	高级功能、快速
Lua	lua-language-server	官方、维护良好
YAML	yaml-language-server	模式验证、完成
JSON	vscode-json-languageserver	模式验证、格式化

有关详细推荐、替代方案和权衡，请参见 server-database.md。

.lsp.json 配置格式

Claude Code 从项目根目录的 .lsp.json 读取 LSP 配置。

基本结构：

{
  "server-name": {
    "command": "server-executable",
    "args": ["--stdio"],
    "extensionToLanguage": {
      ".ext": "language-id"
    },
    "restartOnCrash": true,
    "maxRestarts": 3
  }
}

必需字段：

字段	类型	描述
command	字符串	服务器的可执行命令
args	字符串数组	命令行参数（通常为 ["--stdio"]）
extensionToLanguage	对象	映射文件扩展名到语言 ID

可选字段：

字段	类型	默认值	描述
restartOnCrash	布尔值	true	服务器崩溃时自动重启
maxRestarts	数字	3	最大重启尝试次数

有关完整模式和示例，请参见 configuration-patterns.md。

自动检测策略

为项目自动检测所需 LSP 时：

1. 使用 Glob 模式扫描文件扩展名
2. 使用映射表匹配扩展名到语言
3. 从 server-database.md 推荐服务器

扩展名到语言映射

扩展名	语言	推荐服务器
.py, .pyi	Python	pyright
.ts, .tsx, .js, .jsx	TypeScript/JavaScript	typescript-language-server
.go	Go	gopls
.rs	Rust	rust-analyzer
.cs, .csx	C#	csharp-ls
.c, .h, .cpp, .hpp, .cc	C/C++	clangd
.java	Java	jdtls
.rb	Ruby	solargraph
.php	PHP	intelephense
.lua	Lua	lua-language-server
.yaml, .yml	YAML	yaml-language-server
.json	JSON	vscode-json-languageserver

与现有基础设施集成

与 audit-lsp 的关系

audit-lsp 命令验证现有 .lsp.json 配置。本技能提供：

• audit-lsp 可以验证的服务器推荐
• audit-lsp 检查合规性的配置模式
• audit-lsp 发现问题时的故障排除指导

与 setup-lsp 的关系

setup-lsp 命令创建/更新 .lsp.json 配置。本技能提供：

• 推荐的服务器数据库
• 所选服务器的安装指南
• 生成用的配置模板

测试场景

这些场景应激活此技能：

1. 直接激活：“使用 lsp-management 技能推荐 Python LSP”
2. 设置问题：“如何为我的 TypeScript 项目设置 LSP？”
3. 配置问题：“我的 Go 项目的 .lsp.json 应该是什么样子？”
4. 故障排除：“Python 文件中的 hover 工具提示不工作”
5. 比较：“Python 应该用 pyright 还是 pylsp？”

相关技能

技能	关系
docs-management	委托获取 Claude Code LSP 官方文档
plugin-development	插件可以通过 lspServers 字段提供 LSP 配置

参考资料

详细指南（按需加载）：

• 服务器数据库 - 按语言策划推荐
• 配置模式 - 常见 .lsp.json 模式
• 安装指南 - 每服务器安装命令
• 故障排除 - 常见问题和修复

官方文档（通过 docs-management）：

• 查询：“LSP configuration Claude Code”
• 查询：“.lsp.json format”

版本历史

• v1.0.0 (2026-01-11): 初始发布
  • 12+ 语言的 LSP 服务器推荐
  • 配置模式文档
  • 每服务器安装指南
  • 故障排除指南
  • 与 audit-lsp 和 setup-lsp 集成

---

最后更新

日期： 2026-01-11 模型： claude-opus-4-5-20251101