mirror of https://github.com/SpaceVim/SpaceVim.git synced 2025-01-24 05:30:07 +08:00

2019-10-04 14:13:51 +08:00

title	description	lang
SpaceVim lsp 模块	这一模块为 SpaceVim 提供了 language server protocol 的支持，提供更多语言相关服务。	zh

可用模块 >> lsp

模块描述

lsp 模块提供了 language-server-protocol 的支持，这以模块在 LanguageClient-neovim 基础上做了许多定制，这一链接为一克隆的版本，需要 +python 支持。

同时，当你的 Vim 不支持 +python3 时，我们采用 vim-lsp 这一使用纯 Vim 脚本书写的插件。

Neovim 团队也在尝试实现一个内置的 lsp 框架，后续该框架完成后，在 Neovim 内将默认使用该框架。

在 SpaceVim 内部，lsp 的框架选择逻辑大致时这样的：

if has('nvim')
  " use neovim build-in lsp
elseif has('python3')
  " use LanguageClient-neovim
else
  " use vim-lsp
endif

注：以上所有信息依赖于语言服务器所实现的功能，请查阅 Language Servers 列表。

默认未载入，如需载入该模块，可在配置文件加入：

[[layers]]
  name = "lsp"

Bash

npm i -g bash-language-server

JavaScript:

npm install -g javascript-typescript-langserver

Python:

pip install --user python-language-server

julia:

安装 LanguageServer 包需要 Julia（0.6 或更高版本）.

julia> Pkg.clone("https://github.com/JuliaEditorSupport/LanguageServer.jl")

在 Julia 0.7 新的包管理系统下，可以在 REPL 模式下进行安装，只需要输入 ] 即可切入到包管理模式，然后执行 add LanguageServer 来安装对应的包。

vue:

npm install vue-language-server -g

css:

npm install -g vscode-css-languageserver-bin

ruby:

gem install solargraph

为指定模块启用语言服务器支持，需要在载入模块时，指定 filetypes 选项：

[[layers]]
  name = "lsp"
  filetypes = [
    "rust",
    "javascript"
  ]

默认语言服务器的执行命令列表如下：

语言	命令
`c`	`['clangd']`
`cpp`	`['clangd']`
`crystal`	`['scry']`
`css`	`['css-languageserver', '--stdio']`
`dart`	`['dart_language_server']`
`go`	`['go-langserver', '-mode', 'stdio']`
`haskell`	`['hie', '--lsp']`
`html`	`['html-languageserver', '--stdio']`
`javascript`	`['javascript-typescript-stdio']`
`julia`	`['julia', '--startup-file=no', '--history-file=no', '-e', 'using LanguageServer; server = LanguageServer.LanguageServerInstance(STDIN, STDOUT, false); server.runlinter = true; run(server);']`
`objc`	`['clangd']`
`objcpp`	`['clangd']`
`php`	`['php', 'path/to/bin/php-language-server.php']`
`purescript`	`['purescript-language-server', '--stdio']`
`python`	`['pyls']`
`ruby`	`['solargraph', 'stdio']`
`rust`	`['rustup', 'run', 'nightly', 'rls']`
`sh`	`['bash-language-server', 'start']`
`typescript`	`['typescript-language-server', '--stdio']`
`vue`	`['vls']`

如果需要修改语言服务器的命令，在载入模块时，需要指定 override_cmd 选项：

[[layers]]
  name = "lsp"
  filetypes = [
    "rust",
    "javascript"
  ]
  [layers.override_cmd]
    rust = ["rustup", "run", "nightly", "rls"]

快捷键	功能描述
`K` / `SPC l d`	显示文档
`SPC l e`	重命名 symbol

如果 checkers 模块未载入，则以下快捷键将被引入：