vim插件 kotlin-language-server 下载安装及使用教程 - Vim插件网

Ⅰ. 插件描述

Intelligent Kotlin support for any editor/IDE using the Language Server Protocol

Ⅱ. 基本信息

创建日期： 2018-05-28

使用用户： 1

Github星： 399

插件作者： FW

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'fwcd/kotlin-language-server'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'fwcd/kotlin-language-server'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'fwcd/kotlin-language-server'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/fwcd/kotlin-language-server

Ⅳ. 文档说明

# Kotlin Language Server
A language server that provides smart code completion, diagnostics, hover, document symbols, definition lookup, method signature help and more for Kotlin.

Icon

Any editor conforming to LSP is supported, including VSCode and Atom.

Getting Started

See BUILDING.md for build instructions
See Editor Integration for editor-specific instructions
See Roadmap for features, planned additions, bugfixes and changes
See Kotlin Quick Start for a sample project
See Kotlin Debug Adapter for debugging support on JVM
See tree-sitter-kotlin for an experimental Tree-Sitter grammar

This repository needs your help!

The original author created this project while he was considering using Kotlin in his work. He ended up deciding not to and is not really using Kotlin these days though this is a pretty fully-functional language server that just needs someone to use it every day for a while and iron out the last few pesky bugs.

There are two hard parts of implementing a language server:

Figuring out the dependencies
Incrementally re-compiling as the user types

The project uses the internal APIs of the Kotlin compiler.

Dependencies are determined by the findClassPath function, which invokes Maven or Gradle and tells it to output a list of dependencies. Currently, both Maven and Gradle projects are supported.

I get incremental compilation at the file-level by keeping the same KotlinCoreEnvironment alive between compilations in Compiler.kt. There is a performance benchmark in OneFilePerformance.kt that verifies this works.

Getting incremental compilation at the expression level is a bit more complicated:

Fully compile a file and store in CompiledFile:
- val content: String A snapshot of the source code
- val parse: KtFile The parsed AST
- val compile: BindingContext Additional information about the AST from typechecking
After the user edits the file:
- Find the smallest section the encompasses all the user changes
- Get the LexicalScope encompassing this region from the BindingContext that was generated by the full-compile
- Create a fake, in-memory .kt file with just the expression we want to re-compile
  - Add space at the top of the file so the line numbers match up
- Re-compile this tiny fake file

The incremental expression compilation logic is all in CompiledFile.kt. The Kotlin AST has a built-in repair API, which seems to be how IntelliJ works, but as far as I can tell this API does not work if the surrounding IntelliJ machinery is not present. Hence I created the "fake tiny file" incremental-compilation mechanism, which seems to be quite fast and predictable.

There is an extensive suite of behavioral tests, which are all implemented in terms of the language server protocol, so you should be able to refactor the code any way you like and the tests should still work.

Modules

Name	Description
server	The language server executable
shared	Classpath resolution and utilities

Scripts

Name	Command	Description
update_kt_version.py	`python3 scripts/update_kt_version.py`	Finds and updates the Kotlin compiler/plugin version for this project
bump_version.py	`python3 scripts/bump_version.py`	Increments the project version and creates a new tag

Protocol Extensions

The Kotlin language server supports some non-standard requests through LSP. See KotlinProtocolExtensions for a description of the interface. The general syntax for these methods is kotlin/someCustomMethod.