Neovim 写 Java 10 分钟上手：nvim-jdtls 配置全攻略（ftplugin vs vim.lsp.config）

Neovim 写 Java 10 分钟上手nvim-jdtls 配置全攻略ftplugin vs vim.lsp.config【免费下载链接】nvim-jdtlsMIRROR of: https://codeberg.org/mfussenegger/nvim-jdtls项目地址: https://gitcode.com/gh_mirrors/nv/nvim-jdtlsnvim-jdtls 是为 Neovim 内置 LSP 打造的 Java 扩展插件专门对接 Java 语言服务器 eclipse.jdt.ls提供代码补全、诊断、重构和调试能力。它解决的不是能不能用 LSP的问题而是怎么把 Java 工程体验做到接近 IDE的问题。为什么写 Java 要单独装一个 nvim-jdtls一句话总结Java 是所有语言里对 LSP 要求最苛刻的。eclipse.jdt.ls 必须识别 Gradle/Maven 工程才能提供完整功能裸vim.lsp.enable拿不到这些扩展能力Java 的重构提取变量/方法、生成toString、调试、测试跳转都需要客户端与服务端协商扩展协议启动jdtls脚本本身依赖 Python 3.9直接裸启动也容易踩环境坑nvim-jdtls 就是填这个坑的它接管客户端扩展协议init_options.bundles、提供start_or_attach统一入口、注册一批实用命令并顺手打通了 nvim-dap 调试。核心入口在lua/jdtls/setup.lua。三步完成 jdtls 安装与初始化第一步装好语言服务器。eclipse.jdt.ls 本身是独立程序按官方说明安装后确保jdtls命令在$PATH里。注意两个硬性前提eclipse.jdt.ls 要求Java 21运行时jdtls包装脚本要求Python 3.9第二步安装插件。任选其一git clone https://gitcode.com/gh_mirrors/nv/nvim-jdtls ~/.config/nvim/pack/plugins/start/nvim-jdtls-- vim-plug Plug mfussenegger/nvim-jdtls第三步启用服务。最小可运行配置只有一行vim.lsp.enable(jdtls)打开任意 Maven/Gradle 项目里的.java文件jdtls 会自动启动并挂载。如果你希望显式控制启动方式往下看。两种配置路径怎么选ftplugin vs vim.lsp.config先别急这不是哪个更好的问题而是你要多少控制权的问题。vim.lsp.configftplugin配置量一行一个文件几十行默认值来源内置于lsp/jdtls.lua自己全写自定义init_options.bundles通过vim.lsp.config覆盖原生支持适合人群要少维护、够用就好要精细控制 cmd/root_dir内置默认配置很简单你可以直接翻lsp/jdtls.lua验证return { root_markers {.git, gradlew, mvnw}, cmd {jdtls}, filetypes {java}, ... }如果你只要补全和诊断选 vim.lsp.config。需要覆盖设置时用vim.lsp.config(jdtls, { settings { java { -- 你的 eclipse.jdt.ls 选项 }, }, }) vim.lsp.enable(jdtls)如果你需要自定义cmd、root_dir或要挂调试扩展包选 ftplugin。在~/.config/nvim/ftplugin/java.lua中local config { name jdtls, cmd {jdtls}, root_dir vim.fs.root(0, {gradlew, .git, mvnw}), settings { java {} }, init_options { bundles {} }, -- 挂 java-debug 等扩展包时填这里 } require(jdtls).start_or_attach(config)⚠️ 两条路径只能选一条同时启用会互相打架。建议顺手配置-data目录。jdtls 的工程索引默认存在系统临时目录部分发行版重启后清理导致每次开机全量重建索引。在cmd里追加-data /你的/工作区目录/项目名即可让索引常驻。进阶能力重构命令与调试集成服务正常启动后除了原生vim.lsp.buf.*全部可用nvim-jdtls 还注册了一批扩展命令:JdtCompile/:JdtUpdateConfig—— 编译与刷新依赖配置:JdtSetRuntime—— 运行时切换语言级别:JdtBytecode/:JdtJshell—— 查看字节码、用项目 classpath 开 jshell:JdtShowLogs/:JdtWipeDataAndRestart—— 排错利器:JdtRestart—— 重启语言服务器重构类功能靠映射触发例如nnoremap A-o Cmdlua requirejdtls.organize_imports()CR nnoremap crv Cmdlua require(jdtls).extract_variable()CR重点是调试。装上 nvim-dap 并获取 java-debug 扩展包后把它塞进init_optionsconfig[init_options] { bundles { vim.fn.glob(path/to/com.microsoft.java.debug.plugin-*.jar, 1) }, }之后:DapNew会自动发现项目里的 main 类调试 JUnit 测试则有两个现成函数requirejdtls.test_class() -- 调试当前测试类 requirejdtls.test_nearest_method() -- 调试光标所在测试方法踩坑与排错jdtls 常见报错逐个拆解打开 Java 文件提示 non-project file, only syntax errors are reported现象补全、跳转全部失效只剩语法检查。原因当前文件不在 Gradle/Maven 工程里jdt.ls 只能按散文件处理。解法把项目用 Gradle 或 Maven 管理起来有pom.xml或build.gradle。jdtls 完整能力依赖构建工具解析依赖这是硬前提。打开 Java 文件毫无反应vim.lsp.buf 全部报错现象客户端似乎根本没启动。原因配置没在FileType事件里执行start_or_attach或配置本身有 Lua 错误。解法手动执行:set ftjava后看:messages输出再不行打开日志定位——:lua print(vim.fn.stdpath(cache))找到lsp.log必要时提高日志级别。报 Java XX language features are not available现象高版本 Java 语法record、sealed 等不识别。原因jdt.ls 运行用的 JDK 与项目目标版本不一致且没声明可用运行时。解法在settings中注册运行时name必须与官方枚举值严格匹配settings { java { configuration { runtimes { { name JavaSE-17, path /usr/lib/jvm/java-17-openjdk/ }, }, }, }, }也可以直接用:JdtSetRuntime在运行时切换。报 Unable to access jarfile 或 Unrecognized option: --add-modules现象服务启动即退出。原因前者是cmd里的路径用了~Neovim 不会自动展开需vim.fn.expand处理后者是 JDK 版本低于 21。解法路径写绝对路径或走expand给 jdtls 装上 Java 21。大型项目补全卡顿现象每敲一个字符都等半天。原因自动补全插件触发过于激进jdt.ls 的补全请求在大项目上开销很高。解法降低自动补全触发频率或改为手动C-Space触发。写在最后nvim-jdtls 的思路很克制把 Neovim 内置 LSP 在 Java 上缺的那块补齐其余能力交给原生vim.lspAPI。配置本身只有两条路选一条、跑通:JdtCompile剩下的都是加分项。延伸阅读API 参考文档doc/jdtls.txtNeovim 内:help jdtls主入口lua/jdtls.lua启动逻辑lua/jdtls/setup.lua内置 LSP 配置lsp/jdtls.lua【免费下载链接】nvim-jdtlsMIRROR of: https://codeberg.org/mfussenegger/nvim-jdtls项目地址: https://gitcode.com/gh_mirrors/nv/nvim-jdtls创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考