Roxum IDE 是一款免费开源、专为 Android 打造的轻量级 IDE / 代码编辑器。它的杀手锏之一是内置 LSP（Language Server Protocol，语言服务器协议）支持：打开代码文件时，自动获得智能补全、悬停提示、语义高亮和错误高亮等"IDE 级"体验。本文手把手带你完成 Roxum IDE LSP 的开启与功能配置，让手机写码像桌面端一样顺手。

什么是 LSP，它能给你带来什么？

简单说，LSP 就是编辑器和"语言智能大脑"之间的通信协议。启用后，Roxum IDE 会为每种语言拉起对应的语言服务器，你无需任何插件即可享受：

• ⚡代码补全（Code Completion）：敲几个字母就弹出候选项
• ❌错误高亮（Diagnostics）：语法与类型错误实时标红
• 🖱悬停信息（Hover Info）：查看函数签名、类型定义
• 🎨语义高亮 / 文档高亮：变量、函数、关键字各显其色
• 🔀跳转定义、重命名、内联提示（Inlay Hints）等

相关能力声明可见 README.md 的 Feature list。

一键开启步骤：设置页里的 LSP 开关

Roxum IDE 的 LSP 默认是开启状态（配置项enableLSP默认为true），但建议确认一下：

1. 进入Settings（设置）页，找到LSP Configuration区块
2. 确认Enable LSP support开关为On—— 它提供代码建议、悬停详情、智能高亮等能力
3. 点击Configure LSP Features，可按语言逐项勾选/取消 12 种功能：

💡 小技巧：给某项打勾代表禁用该功能（列表旁会显示橙色N disabled角标）。如果某语言卡顿，可以只针对它关掉 Inlay Hints 或 Code Folding 来减负。

该设置界面的源码位于 lib/ui/settings.dart。

Roxum IDE LSP 支持哪些语言？各用哪个服务器？

各语言对应的语言服务器在 lib/utils/languages.dart 中通过lspExecutable字段注册：

注意：设置页也明确提示LSP 支持仅覆盖部分语言，未在表中的语言只有语法着色，没有智能提示。

下载语言服务器：LSP 不起作用时先查这里

语言服务器是可按需下载的组件（Play Feature Delivery），首次使用某语言的 LSP 前，请先到应用内的Downloads（下载）页安装对应项，例如：

• Rust →rust-analyzer
• Go →gopls
• Java / Kotlin →Kmp LSP
• JavaScript / TypeScript / HTML / CSS / JSON →VSCode Extracted LSP Servers（依赖Node运行时）
• Lua →EmmyLuaLs、Zig →zls、Bash →bash-language-server

可下载组件清单及其安装模块定义在 lib/ui/downloads.dart。若 GitHub Copilot 等 AI 功能提示缺失运行时，也遵循同样的"打开 Downloads 安装"流程（见 lib/ui/settings.dart）。

LSP 的启动机制：打开文件时自动发生

你不需要手动"启动"任何服务。以项目模式打开文件时，编辑器会读取enableLSP配置，若为开启状态，则按文件扩展名匹配语言，调用该语言的lspExecutable启动（或复用已运行的）共享语言服务器，例如：

• rust-analyzer、gopls、kmp-lsp、zls等直接以原生二进制运行
• 基于 Node 的服务器（JS/TS/HTML/CSS 等）以node --stdio方式运行

核心调度逻辑见 lib/ui/editor_page.dart 与 lib/ui/editor_page.dart：只要enableLSP为真且不是预览文件，就会自动拉起对应 LSP，补全、悬停、错误高亮即刻生效。

常见问题排查清单

• 没有补全/不高亮错误→ ① 确认 Settings 中Enable LSP support为 On；② 到 Downloads 安装该语言的语言服务器（见上表）；③ 确认语言在支持列表内
• 功能被误关了→ 进入 Configure LSP Features，取消对应功能前的勾选（勾选=禁用）
• 首次打开大项目补全慢→ 属正常现象，语言服务器需要时间索引整个工程，稍等片刻即可
• 想省性能→ 对特定语言禁用 Inlay Hints、Code Folding 等非核心功能

总结

Roxum IDE 的 LSP 配置其实只有两步：确认Settings → LSP Configuration总开关开启，再按需到Downloads页安装对应语言服务器。配合可按语言、按功能粒度开关的 12 项特性，这款免费开源的安卓 IDE 就能提供接近桌面级的补全、建议与错误高亮体验。