VSCode配置Java开发环境：从JDK安装到Maven项目管理-VSCode-PHP中文网

VSCode报JDK not found主因是java.home未指向JDK根目录或环境变量不一致；应通过Java: Configure Java Runtime手动添加JDK，并确保JAVA_HOME与java -version/javac -version输出一致，同时右键pom.xml导入项目并正确配置~/.m2/settings.xml。

vscode配置java开发环境：从jdk安装到maven项目管理

VSCode 本身不带 Java 运行时，装完 JDK 和插件后仍报 JDK not found 或 java.home 报红，不是 JDK 没装好，而是 VSCode 没读到你真正想用的那个 JDK 路径——尤其当你有多个 JDK 或从终端启动 VSCode 时环境变量不一致，问题会更隐蔽。

确认 JAVA_HOME 指向的是 JDK 根目录，不是 bin 或 jre

这是最常踩的坑。路径必须是 JDK 解压/安装后的顶层目录，例如：

C:\Program Files\Eclipse Adoptium\jdk-17.0.2+8（Windows）
/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home（macOS）
/opt/java/jdk-17.0.2（Linux）

别写成 .../bin 或 .../jre；否则 java.home 配置会静默失败，Language Server 启动不了。终端执行 java -version 和 javac -version 必须输出一致版本号，否则说明 PATH 或 JAVA_HOME 没生效。

用 Java: Configure Java Runtime 手动添加 JDK，比改 settings.json 更可靠

VSCode 的 Java 扩展（redhat.java）优先读取这个界面配置，而非仅依赖 java.home。按 Ctrl+Shift+P（或 Cmd+Shift+P），输入并运行 Java: Configure Java Runtime：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

在 “JDKs” 标签页里点 Add JDK，直接选中你确认有效的 JDK 根目录
如果已有多个 JDK，勾选你希望项目默认使用的那个，并留意右下角是否出现 Java Language Server is running
若之前在 settings.json 里硬写了 java.configuration.runtimes，且含已卸载的旧 JDK 路径，删掉它——这类残留配置会覆盖界面设置

Maven 项目不识别依赖、import 报红？先右键 pom.xml → Import to Workspace

VSCode 不会自动把 pom.xml 当作项目入口。只新建文件、放个 pom.xml 是不够的，必须显式触发导入：

在资源管理器中右键 pom.xml 文件，选 Import to Workspace（不是 “Open with” 或 “Run as Maven build”）
观察状态栏右下角：出现 Building workspace → 完成后显示 Java Projects: 1 project 才算成功
若弹出 Project configuration is not up-to-date with pom.xml，点通知里的 Update project（等效于刷新依赖和 classpath）
如果项目用了私有仓库，确保 ~/.m2/settings.xml 已被加载：用命令面板运行 Maven: Change Settings，手动指向它

mvn compile 失败但终端能跑？检查 Maven 插件是否用了错误的 settings.xml

VSCode 的 Maven 插件默认只读全局 $MAVEN_HOME/conf/settings.xml，而多数人把镜像、认证写在用户级 ~/.m2/settings.xml。结果就是：终端里 mvn compile 成功，VSCode 里却连 spring-boot-starter-web 都下载不了。

打开命令面板，运行 Maven: Change Settings，选你实际编辑过的 ~/.m2/settings.xml
检查该文件中路径是否可写（避免设为 C:\Program Files\...）
若用 Nexus/Artifactory，确认的 id 和的 mirrorOf 匹配，且文件权限允许 VSCode 读取（macOS/Linux 上 chmod 600 ~/.m2/settings.xml）