Emacs lsp-mode 对 Ruff Server 的支持与配置指南

随着 Ruff 项目的快速发展，其官方团队推出了全新的 Ruff Server 实现。作为一款基于 Rust 重写的语言服务器，它正在逐步取代原有的 Python 实现版本 ruff-lsp。本文将详细介绍如何在 Emacs 的 lsp-mode 中配置和使用这一新服务。

Ruff Server 的技术背景

Ruff Server 是 Astral 团队使用 Rust 语言重新实现的 LSP 服务，相比之前的 Python 版本具有显著的性能优势。作为 ruff-lsp 的继任者，它提供了更快的响应速度和更低的内存占用。该功能在 Ruff v0.4.5 版本中作为预览功能推出，标志着 Ruff 工具链向更高性能方向迈进的重要一步。

基本配置方法

在 lsp-mode 中配置 Ruff Server 非常简单，主要有两种方式：

1. 注册新客户端（推荐方式）：

(with-eval-after-load 'lsp-mode
  (lsp-register-client
   (make-lsp-client :new-connection (lsp-stdio-connection '("ruff" "server" "--preview"))
     :major-modes '(python-mode)
     :priority 1
     :add-on? t
     :multi-root t
     :server-id 'ruff-server)))

2. 修改现有配置（快捷方式）：

(with-eval-after-load 'lsp-mode
  (setq lsp-ruff-lsp-server-command '("ruff" "server")))

配置说明

• --preview 参数表示使用预览版功能，随着版本迭代可能会逐步移除
• :priority 1 确保 Ruff Server 优先于其他 Python 语言服务器
• :add-on? t 允许与其他语言服务器（如 Pyright）协同工作
• 建议同时禁用旧的 ruff-lsp：(setq! lsp-disabled-clients '(python-mode . (ruff-lsp)))

注意事项

1. 确保已安装最新版 Ruff（≥0.4.5）
2. 该功能目前仍处于测试阶段，可能有不稳定的情况
3. 与 Python 生态中其他工具（如 black、isort）的集成可能需要额外配置
4. 如果使用虚拟环境，需要确保 Ruff 安装在正确的 Python 环境中

性能优化建议

由于 Ruff Server 采用 Rust 实现，理论上应该比原有版本更快。但用户仍可通过以下方式进一步优化体验：

1. 在大型项目中，考虑增加 Ruff 的缓存设置
2. 调整 lsp-mode 的延迟触发时间
3. 监控内存使用情况，特别是在长期运行的 Emacs 会话中

随着 Ruff 项目的持续发展，预计 Ruff Server 将很快成为 Python 代码分析的默认选择。Emacs 用户通过上述配置可以提前体验这一改进，为未来的平滑过渡做好准备。