java.home配置不生效时如何在VS Code中创建Maven项目

问题背景 #

在VS Code内创建Maven项目时触发报错，提示JAVA_HOME未配置，尝试多种方案均未解决。

已尝试的无效操作 #

• 进入控制面板配置系统环境变量，将JAVA_HOME、PATH项指向本地JDK安装路径
• 编辑VS Code的settings.json文件添加Java路径指定、JAVA_HOME声明参数，曾写入如下无效配置，后续已移除：

"java.home": "C:\Program Files\Java\jdk-9.0.4"
"maven.terminal.useJavaHome": true

• 调整Java路径配置项前缀，尝试使用java.jdt.ls.java.home类配置项指定路径，依然无效
• 查阅插件官方说明、技术社区相关问题帖，未找到可行解决方案

修复步骤（按顺序操作，每步完成后验证） #

1. 校验系统环境变量实际加载状态
   配置完环境变量后必须新开命令提示符窗口（旧窗口不会加载新配置），依次执行三条命令校验：
   • echo %JAVA_HOME%：返回结果必须是JDK根目录，不能带\bin后缀，正确示例：C:\Program Files\Java\jdk-9.0.4
   • java -version：返回版本号要和你安装的JDK版本一致
   • mvn -v：输出内容里的Java路径要和JAVA_HOME路径完全匹配
     如果以上任意一条校验不通过：
   • 重新配置系统环境变量，所有配置窗口必须点「确定」保存，不能直接点右上角关闭，很多人配置完不点确定直接关窗口，等于完全没保存，白忙活
   • 打开PATH配置项，把%JAVA_HOME%\bin的优先级拖到最顶部，避免其他软件自带的JRE/JDK路径优先级更高被优先加载
2. 修正VS Code配置错误
   之前写入的json配置存在路径格式错误：Windows路径的反斜杠在json文件里属于转义字符，直接写单斜杠会导致配置解析失败，正确配置如下，直接复制替换对应内容即可：

   "java.jdt.ls.java.home": "C:/Program Files/Java/jdk-9.0.4",
   "maven.terminal.useJavaHome": true,
   "maven.terminal.customEnv": [
       {
           "environmentVariable": "JAVA_HOME",
           "value": "C:/Program Files/Java/jdk-9.0.4"
       }
   ]
   

   注意：新版本VS Code Java插件已经废弃了旧的java.home配置项，必须使用java.jdt.ls.java.home才能被插件识别

3. 清理缓存重载服务
   配置修改完成后，按Ctrl+Shift+P调出命令面板，执行Java: Clean Java Language Server Workspace命令，等待语言服务重启后，完全退出VS Code（包括后台驻留的VS Code进程），重新打开再尝试创建Maven项目。
4. 校验运行时JDK绑定
   如果以上操作完成后依然报错，再次调出命令面板执行Java: Configure Java Runtime，在Maven分类页下确认绑定的JDK路径为本地安装的JDK9路径，不要关联到JRE或者其他版本的JDK。

相关问题截图 #

• 报错提示截图1
• 报错提示截图2

内容的提问来源于stack exchange，提问作者Deddor