You need to enable JavaScript to run this app. 如何在VSCodium中通过Redhat插件运行Java Gradle项目
优惠活动
大模型
产品
解决方案
定价
更多

如何在VSCodium中通过Redhat插件运行Java Gradle项目

问题核心原因

SDKMAN 安装的 Java 环境默认托管在用户家目录的隐藏路径下,该路径的环境变量是通过 Shell 启动时加载的用户配置文件(.bashrc/.zshrc 等)注入系统会话的。通过桌面启动器、系统菜单打开的 VSCodium 属于图形界面启动的进程,不会加载 Shell 层面的用户环境配置,因此无法自动识别 SDKMAN 配置的 JDK 路径,最终触发“未检测到有效 Java 运行环境”的报错。

完整配置步骤
  • 获取本地 JDK 的实际根路径
    在终端执行 echo $JAVA_HOME,记录终端输出的 JDK 根目录路径。针对当前用户的安装环境,该路径的标准值为 /home/nicholas/.sdkman/candidates/java/current(该路径为SDKMAN的当前激活版本软链路径,指向实际安装的JDK目录)。
  • 配置VSCodium Java插件的识别路径
    1. 打开VSCodium,按快捷键 Ctrl+, 调出设置面板
    2. 在设置顶部的搜索框输入 java.jdt.ls.java.home,定位到Red Hat Java插件对应的运行环境配置项
    3. 将之前获取的JDK根路径填入配置输入框
      注意:此处必须填写JDK的根目录(即目录下包含bin、lib等子文件夹的层级),不能填写bin目录下的java可执行文件路径,否则会触发识别失败
      也可以直接通过JSON配置文件完成设置:按 Ctrl+Shift+P 调出命令面板,输入 Open User Settings (JSON) 打开全局配置文件,补充如下配置:
    {
      "java.jdt.ls.java.home": "/home/nicholas/.sdkman/candidates/java/current",
      "java.configuration.runtimes": [
        {
          "name": "JavaSE-11",
          "path": "/home/nicholas/.sdkman/candidates/java/current",
          "default": true
        }
      ]
    }
    
    其中java.jdt.ls.java.home 是Java语言服务自身运行依赖的JDK路径(要求JDK版本不低于11,与当前安装的版本完全匹配);java.configuration.runtimes 是给项目编译、运行时提供的匹配运行时列表,用于插件自动关联项目的编译环境。
  • 配置Gradle插件的JDK识别路径
    在VSCodium设置搜索框输入 gradle.java.home,将同样的JDK根路径填入,避免Gradle同步环节再次出现JDK识别失败。
  • 重置Java语言服务缓存
    按 Ctrl+Shift+P 调出命令面板,执行 Java: Clean Java Language Server Workspace,等待VSCodium自动重启Java语言服务、重新加载项目索引即可。
项目IDE内运行操作

等项目索引加载完成后:

  • 在左侧资源管理器定位到项目中包含main方法的主启动类
  • 点击文件名旁的运行下拉按钮,选择Run Java即可直接启动项目,无需切换到终端执行Gradle命令
  • 如果需要断点调试,选择Debug Java选项即可直接进入调试模式
常见注意事项
  • 所有配置项保存在VSCodium的用户全局配置中,重启VSCodium、重启整机系统都不会丢失,无需重复配置
  • 如果后续通过SDKMAN切换了JDK版本,由于使用的是SDKMAN的current软链路径,不需要修改VSCodium配置,插件会自动读取软链指向的最新版本

内容的提问来源于stack exchange,提问作者Nicholas Saunders

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 10:06:02