LSP 是什么?
LSP 全称是 Language Server protocol , 是由 Microsoft 主持开发的通用语言分析器协议. 最初是为 Visual Studio Code 开发的, 现在是一个开放的标准 1 . 它是一个 JSON-RPC -based 的协议 2 , 用于编辑器或 IDE 与提供语言分析补全等功能的服务的通信, 编辑器 / IDE 和语言服务甚至可以在不同的机器上 1 . 理查德·斯托曼 也支持该协议 3 .
准备
Python 环境端
Python Language Server 就是 Python 语言服务的实现, 遵从了 LSP 协议. 使用 jedi 提供了诸如补全等功能.
使用 pipenv 管理 Python 环境
cd project_floder pipenv install python-language-server[all]# pipenv install python-language-server[all] --skip-lock
Emacs 编辑器端
需要安装以下几个包, 如果使用 elpa 管理包, 添加 melpa 源后 M-x package-install <RET> 安装即可
-
lsp-mode#Emacs 下 LSP 协议库 -
company-lsp#使用 company 提供补全的后端 -
lsp-ui#提供诸如 flycheck 等功能
Python 和 Emacs 准备阶段结束.
Emacs 配置
使用以下配置需要安装 use-package
(use-package lsp-mode
:config
(add-hook 'python-mode-hook
(lambda ()
(lsp-python-enable)))
;; 调用 pyls 既上边安装的 Python Language Server
;; 不需要安装 lsp-python, 以下几行提供与 lsp-python 相同的功能
(lsp-define-stdio-client lsp-python "python"
(lsp-make-traverser #'(lambda (dir)
(directory-files
dir
nil "\\(__init__\\|setup\\)\\.py\\|Pipfile"))) '("pyls")))
(use-package lsp-imenu
:init
;; 启用 lsp-imenu 集成
(add-hook 'lsp-after-open-hook 'lsp-enable-imenu))
(use-package lsp-ui
:init
;; 启用 lsp-ui
(add-hook 'lsp-mode-hook 'lsp-ui-mode)
;; 启用 flycheck
(add-hook 'python-mode-hook 'flycheck-mode))
(use-package company-lsp
:config
;; 设置 company-lsp 为后端
(push 'company-lsp company-backends))
其它
Python Language Server 可以不必在每个环境中都安装, 以 pipenv 为例, 安装 Python Language Server 到全局 Python 中, 然后在每个环境下 pipenv shell 进入环境即可补全该环境下的包.
(lsp-define-stdio-client lsp-python "python"
(lsp-make-traverser #'(lambda (dir)
(directory-files
dir nil
"\\(__init__\\|setup\\)\\.py\\|Pipfile"))) '("pyls"))
这段配置说明了需要在目录下能找到 __init__.py 等文件后将其作为 project root 使用, 如果没找到相应文件, 则会抛出找不到项目根目录的 Warning , 并且是以 *Warnings* buffer 的形式显示的, 在 lsp-mode 的 :config 后加入下面一句, 就可以用 Message 而不是 buffer 的形式显示 Warning.
(setq lsp-message-project-root-warning t)
看个人简介
图文来源于网络：侵删
