AI总结的, 请升级到2.1.0 ,不爱请别伤害。

适用于 Claude Code v2.1.0+,基于 Anthropic 官方插件市场 claude-plugins-official

什么是 LSP?为什么你需要它?

LSP (Language Server Protocol) 是微软推出的语言服务器协议,它将代码智能功能(补全、跳转定义、查找引用、诊断等)与编辑器解耦。

在 Claude Code 中启用 LSP 后,AI 可以:

  • 🎯 精准跳转 - 一键跳转到函数/类定义
  • 🔍 智能引用 - 查找所有调用位置
  • ⚠️ 实时诊断 - 编码时即时发现错误
  • 📝 悬停文档 - 鼠标悬停显示类型信息

官方 LSP 插件一览

以下是 claude-plugins-official 市场提供的 11 种语言 LSP 插件

插件名 语言 LSP Server 支持文件类型
typescript-lsp TypeScript / JavaScript typescript-language-server .ts .tsx .js .jsx .mts .cts .mjs .cjs
pyright-lsp Python pyright-langserver .py .pyi
gopls-lsp Go gopls .go
jdtls-lsp Java Eclipse JDT.LS .java
csharp-lsp C# csharp-ls .cs
kotlin-lsp Kotlin kotlin-lsp .kt .kts
rust-analyzer-lsp Rust rust-analyzer .rs
clangd-lsp C / C++ clangd .c .h .cpp .cc .cxx .hpp .hxx
php-lsp PHP intelephense .php
swift-lsp Swift sourcekit-lsp .swift
lua-lsp Lua lua-language-server .lua

快速安装三步走

Step 1: 添加官方市场

claude plugin marketplace add https://github.com/anthropics/claude-plugins-official.git

Step 2: 安装系统依赖 (LSP Server)

根据你使用的语言,安装对应的 LSP Server:

前端开发
# TypeScript / JavaScript
npm install -g typescript-language-server typescript
后端开发
# Python
pip install pyright

# Go
go install golang.org/x/tools/gopls@latest

# Java (需要 Java 21+ 运行时)
# macOS
brew install jdtls
# Windows/Linux: 下载 Eclipse JDT LS
# https://download.eclipse.org/jdtls/snapshots/

# C#
dotnet tool install -g csharp-ls

# Kotlin
# macOS
brew install kotlin-language-server
# 其他: https://github.com/fwcd/kotlin-language-server/releases

# PHP
npm install -g intelephense
系统开发
# Rust
rustup component add rust-analyzer

# C / C++
# macOS
brew install llvm
# Ubuntu/Debian
sudo apt install clangd
# Windows: 安装 LLVM https://releases.llvm.org/

# Swift (macOS)
# Xcode 自带,无需额外安装
脚本语言
# Lua
# macOS
brew install lua-language-server
# 其他: https://github.com/LuaLS/lua-language-server/releases

Step 3: 安装 Claude Code 插件

# 按需安装
claude plugin install typescript-lsp@claude-plugins-official
claude plugin install pyright-lsp@claude-plugins-official
claude plugin install gopls-lsp@claude-plugins-official
claude plugin install jdtls-lsp@claude-plugins-official
claude plugin install csharp-lsp@claude-plugins-official
claude plugin install kotlin-lsp@claude-plugins-official
claude plugin install rust-analyzer-lsp@claude-plugins-official
claude plugin install clangd-lsp@claude-plugins-official
claude plugin install php-lsp@claude-plugins-official
claude plugin install swift-lsp@claude-plugins-official
claude plugin install lua-lsp@claude-plugins-official

一键全装脚本 (Bash):

for lsp in typescript-lsp pyright-lsp gopls-lsp jdtls-lsp csharp-lsp kotlin-lsp rust-analyzer-lsp clangd-lsp php-lsp lua-lsp; do
  claude plugin install ${lsp}@claude-plugins-official
done

各语言最佳实践

TypeScript / JavaScript

推荐配置: typescript-lsp

npm install -g typescript-language-server typescript
claude plugin install typescript-lsp@claude-plugins-official

特点:

  • 支持 .ts .tsx .js .jsx 及 ESM/CJS 模块
  • 完整的类型推断和补全
  • 自动导入建议

项目要求: 项目根目录需要 tsconfig.jsonjsconfig.json


Python

推荐配置: pyright-lsp

pip install pyright
claude plugin install pyright-lsp@claude-plugins-official

特点:

  • 微软出品,类型检查最严格
  • 支持 .py.pyi 存根文件
  • 速度快,内存占用低

项目要求: 建议添加 pyrightconfig.jsonpyproject.toml 配置类型检查级别


Go

推荐配置: gopls-lsp

go install golang.org/x/tools/gopls@latest
claude plugin install gopls-lsp@claude-plugins-official

特点:

  • Go 官方维护
  • 完美支持 Go modules 和 workspace
  • 重构、代码生成能力强

注意: 确保 $GOPATH/bin~/go/bin 在 PATH 中


Java

推荐配置: jdtls-lsp

# macOS
brew install jdtls

# 或手动下载
# https://download.eclipse.org/jdtls/snapshots/
claude plugin install jdtls-lsp@claude-plugins-official

特点:

  • Eclipse 基金会维护
  • 支持 Maven、Gradle 项目
  • 启动较慢(startupTimeout: 120000),但功能完整

项目要求: 需要 Java 21+ 运行时,项目需有 pom.xmlbuild.gradle


C#

推荐配置: csharp-lsp

dotnet tool install -g csharp-ls
claude plugin install csharp-lsp@claude-plugins-official

特点:

  • 轻量级 C# 语言服务器
  • 支持 .NET Core / .NET 5+ 项目
  • 比 OmniSharp 更轻便

替代方案: 如需完整 Visual Studio 体验,可考虑 OmniSharp


Kotlin

推荐配置: kotlin-lsp

# macOS
brew install kotlin-language-server

# 其他平台从 GitHub Releases 下载
claude plugin install kotlin-lsp@claude-plugins-official

特点:

  • 支持 .kt.kts 脚本
  • 启动超时设置为 120 秒(JVM 启动较慢)

Rust

推荐配置: rust-analyzer-lsp

rustup component add rust-analyzer
claude plugin install rust-analyzer-lsp@claude-plugins-official

特点:

  • Rust 社区首选
  • 宏展开、生命周期分析
  • 与 Cargo 深度集成

C / C++

推荐配置: clangd-lsp

# macOS
brew install llvm

# Ubuntu/Debian
sudo apt install clangd

# 添加到 PATH (macOS)
export PATH="/opt/homebrew/opt/llvm/bin:$PATH"
claude plugin install clangd-lsp@claude-plugins-official

特点:

  • LLVM 项目维护
  • 后台索引(--background-index
  • 支持 compile_commands.json

项目要求: 建议生成 compile_commands.json(CMake: -DCMAKE_EXPORT_COMPILE_COMMANDS=ON


PHP

推荐配置: php-lsp

npm install -g intelephense
claude plugin install php-lsp@claude-plugins-official

特点:

  • 市场上最快的 PHP LSP
  • 支持 Laravel、Symfony 等框架
  • 免费版功能足够日常使用

Swift

推荐配置: swift-lsp

# macOS 无需安装,Xcode 自带 sourcekit-lsp
claude plugin install swift-lsp@claude-plugins-official

特点:

  • Apple 官方维护
  • 与 Swift Package Manager 集成

注意: 仅限 macOS


Lua

推荐配置: lua-lsp

# macOS
brew install lua-language-server

# 其他平台从 GitHub 下载
claude plugin install lua-lsp@claude-plugins-official

特点:

  • 支持 Lua 5.1 ~ 5.4
  • 适用于游戏开发(Roblox、Love2D)、Neovim 配置

验证安装

安装完成后,检查插件状态:

# 查看已安装插件
cat ~/.claude/plugins/installed_plugins.json

# 验证 LSP Server 可执行
which typescript-language-server  # TS/JS
which pyright-langserver          # Python
which gopls                       # Go
which jdtls                       # Java
which csharp-ls                   # C#
which rust-analyzer               # Rust
which clangd                      # C/C++
which intelephense                # PHP
which lua-language-server         # Lua

常见问题

Q: LSP 插件安装后不生效?

A: 确保 Claude Code 版本 ≥ 2.1.0,旧版本有 LSP race condition bug。

claude --version  # 检查版本
claude update     # 更新到最新

Q: Java/Kotlin LSP 启动很慢?

A: 正常现象,JVM 冷启动需要时间。官方配置已设置 startupTimeout: 120000(2分钟)。

Q: 找不到 LSP Server 命令?

A: 检查 PATH 环境变量,确保 LSP Server 所在目录已添加:

# Go
export PATH="$HOME/go/bin:$PATH"

# .NET Tools
export PATH="$HOME/.dotnet/tools:$PATH"

# Homebrew LLVM (macOS)
export PATH="/opt/homebrew/opt/llvm/bin:$PATH"

Q: 官方市场 vs 第三方市场?

A: 优先使用 claude-plugins-official

  • Anthropic 官方维护
  • 配置经过优化测试
  • 更新及时、兼容性好

第三方市场如 boostvolt/claude-code-lsps 可作为补充,提供更多小众语言支持。


总结

你的技术栈 推荐安装
全栈 Web typescript-lsp + pyright-lsp
后端 Java/Kotlin jdtls-lsp + kotlin-lsp
云原生 Go gopls-lsp
.NET 开发 csharp-lsp
系统编程 rust-analyzer-lsp + clangd-lsp
游戏/脚本 lua-lsp + swift-lsp
PHP Web php-lsp

参考链接

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐