Neovim Java 开发提速实操5 步让 nvim-jdtls 跑通补全、重构与断点调试【免费下载链接】nvim-jdtlsMIRROR of: https://codeberg.org/mfussenegger/nvim-jdtls项目地址: https://gitcode.com/gh_mirrors/nv/nvim-jdtls打开一个 200 个文件的 Java 工程光标停在方法名上补全列表是空的按下跳转定义毫无反应。这种文件能打开但代码不被理解的体验缺的正是语言服务器这一环。nvim-jdtls 把 eclipse.jdt.lsEclipse 项目出品的 Java 语言服务器接到 Neovim 内置的 LSPLanguage Server Protocol让编辑器看懂代码的通信协议上提供代码补全、智能重构和断点调试。这篇 nvim-jdtls 教程的目标读完你能在 15 分钟内让 Neovim 的 Java 体验达到补全可用 → 重构可用 → 断点调试可用。⚙️ nvim-jdtls 是什么依赖链与运行环境一句话定位nvim-jdtls 是给 Neovim 内置 LSP 写的扩展层专门伺候 eclipse.jdt.ls 这个 Java 语言服务器它本身不打包语言服务器。运行时有两个硬要求eclipse.jdt.ls 需要 Java 21 运行官方jdtls启动脚本需要 Python 3.9。和用 lspconfig 裸配 jdtls相比nvim-jdtls 在标准 LSP 能力之外加了organize_imports、extract_method、:JdtCompile这类 Java 专属 API 和命令这些是裸配拿不到的。和装完整 IDE 相比它没有图形界面和项目向导一切靠配置代码configuration as code解决。项目遵循 KISS 原则定位是已有 Neovim、Java 和 Maven / Gradle 基础的用户所以装它之前先确认自己属于这类人。 5 步完成 jdtls 首次启动第 1 步把插件装进 Neovim直接把仓库克隆进 Neovim 的原生包目录用 vim-plug 或 packer 的话一行Plug/use即可等价git clone https://gitcode.com/gh_mirrors/nv/nvim-jdtls ~/.config/nvim/pack/plugins/start/nvim-jdtls这条命令让 Neovim 启动时自动加载插件不依赖任何插件管理器。验证nvim --clean -c lua print(pcall(require, jdtls))输出true即插件已可加载。第 2 步确认 Java 21 和 Python 3.9 就位两个运行时缺一不可先检查版本java --version python3 --version这两条只检查不安装java必须 ≥ 21python3必须 ≥ 3.9。如果 Java 是 17 或 11用系统包管理器装上 JDK 21 并让它成为默认。后面凡是看到Unrecognized option: --add-modulesALL-SYSTEM就是这步没过。第 3 步让 jdtls 可执行文件进 PATH下载 eclipse.jdt.ls 的二进制发行包并解压把其中bin/下的jdtls启动脚本所在目录加进$PATH也可以记下完整路径下一步的cmd里直接写死。验证jdtls终端出现服务器启动日志并停在那里等待连接、没有抛异常说明语言服务器本体可用CtrlC 退出即可。第 4 步写 jdtls 配置ftplugin/java.lua新建~/.config/nvim/ftplugin/java.lua它会在每次打开.java文件时执行local config { name jdtls, cmd {jdtls}, root_dir vim.fs.root(0, {gradlew, .git, mvnw}), settings { java {} }, init_options { bundles {} }, } require(jdtls).start_or_attach(config)root_dir用 gradlew、.git、mvnw 这些标记向上找项目根start_or_attach负责启动服务器并把当前缓冲区挂上去服务器已存在时则只挂载。init_options.bundles先留空后面配调试再填。第 5 步打开 Java 项目验证服务器从一个带pom.xml或build.gradle的工程根目录启动nvim projects/demo/src/main/java/SomeClass.java等几秒看:messages输出没有报错即 jdtls 已接入索引跑完后光标停在方法名上会弹出智能提示gd能跳到定义说明首次启动成功。 三个高频场景整理 import、提取方法、刷新构建整理 importimport 越攒越多、有的缺有的冗余一个键位解决vim.keymap.set(n, leaderoi, Cmdlua require(jdtls).organize_imports()CR)绑进你的init.lua后按leaderoi就删掉多余 import、补上缺失的。效果一句话文件的 import 区永远和 Eclipse 格式化后的样子一致。提取方法、变量、常量函数写太长想拆一块出去或者表达式重复出现想抽成局部变量vim.keymap.set(n, crm, Cmdlua require(jdtls).extract_method()CR) vim.keymap.set(n, crv, Cmdlua require(jdtls).extract_variable()CR) vim.keymap.set(n, crc, Cmdlua require(jdtls).extract_constant()CR)三个映射分别对应提取方法、提取变量、提取常量。效果一句话服务器弹窗问你新名字回车后重构直接落到文件里不用手改。编译工程与刷新依赖改了pom.xml之后不确定服务器状态是否新鲜时直接用它自带的命令:JdtCompile :JdtUpdateConfig第一条编译当前工程错误会进 quickfix 列表第二条让 jdtls 重新读取 Maven / Gradle 项目配置。效果一句话quickfix 里没有红色报错、依赖类的自动补全能出来构建链路就算通了。 进阶配置按需上如果你需要重启后不重新索引系统每次重启清空临时目录jdtls 就会重建项目索引大工程启动很慢。在cmd里固定-data目录local project_name vim.fn.fnamemodify(vim.fn.getcwd(), :p:h:t) local workspace_dir /path/to/workspace-root/ .. project_name local config { cmd { jdtls, -data, workspace_dir }, -- 其余选项同上 }注意workspace 目录要放在专用目录下不要放进项目仓库里否则会被误提交。如果你需要在多个 JDK 版本间切换项目的目标语言版本和运行 jdtls 的 JDK 不一致时比如项目用 Java 17 特性需要在配置里声明可用的运行时settings { java { configuration { runtimes { { name JavaSE-11, path /usr/lib/jvm/java-11-openjdk/ }, { name JavaSE-17, path /usr/lib/jvm/java-17-openjdk/ }, } } } }注意name不是随便起的必须匹配 jdt.ls 的ExecutionEnvironment枚举值运行时也可以用:JdtSetRuntime临时切换语言级别。如果你要断点调试要调试 main 类或 JUnit 测试需要 nvim-dapNeovim 的调试适配器框架加上 java-debug 扩展包local bundles { vim.fn.glob(/path/to/com.microsoft.java.debug.plugin-*.jar, 1), } config[init_options] { bundles bundles }配好后:DapNew能自动发现工程里的 main 类require(jdtls).test_class()可以整个测试类跑起来。注意glob 路径必须指向真实 jar路径里带~时 Neovim 不会自动展开先换成完整路径。⚠️ jdtls 常见坑与一行修复打开 .java 文件后状态栏毫无 LSP 动静现象文件正常打开但没有诊断、没有补全像没装插件。 最常见原因配置没挂在 java 的 filetype 事件下或配置里有 Lua 报错。 修复:set ftjava手动重触发看:messages输出日志用:JdtShowLogs查。报 Unrecognized option: --add-modulesALL-SYSTEM现象服务器一启动就退出。 最常见原因运行 jdtls 的 Java 版本低于 21。 修复切到 JDK 21 后用java --version确认cmd或JAVA_HOME指向新 JDK。日志里 is a non-project file, only syntax errors are reported现象只报语法错误语义功能全部缺席。 最常见原因打开的是孤立 .java 文件周边没有 Maven / Gradle 工程。 修复在该目录建pom.xml或build.gradle然后从工程根重新打开。新加的依赖识别不出来现象pom 里加了依赖补全和跳转还是旧的一批类。 最常见原因服务器没有重读项目配置。 修复:JdtUpdateConfig无效再:JdtRestart。Unable to access jarfile现象配置 bundles 时报 jar 打不开但文件明明存在。 最常见原因路径里写了~Neovim 在cmd里不会自动展开。 修复把~换成完整路径或用vim.fn.expand包一层。命令作用:JdtCompile编译当前工程错误进 quickfix:JdtUpdateConfig重读 Maven / Gradle 项目配置:JdtSetRuntime切换工程目标 JDK 语言级别:JdtRestart重启语言服务器:JdtBytecode用 javap 查看当前文件字节码:JdtJshell带工程 classpath 打开 jshell:JdtShowLogs查看服务器日志:JdtWipeDataAndRestart清除损坏的 workspace 并重启✅ 下一步补全、重构、调试三条线在 Neovim 里已经接上了。想继续深入从源码读起服务器启动与挂载逻辑lua/jdtls/setup.lua内置 lspconfig 入口lsp/jdtls.lua完整 API 与命令帮助doc/jdtls.txt建议先做一件事把leaderoi绑成organize_imports然后在 import 最乱的那个工程里连按三次看看无 IDE 重构是什么手感。【免费下载链接】nvim-jdtlsMIRROR of: https://codeberg.org/mfussenegger/nvim-jdtls项目地址: https://gitcode.com/gh_mirrors/nv/nvim-jdtls创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考