VSCode提示“Java Home not set”需手动配置java.home路径，因其不读系统PATH或JAVA_HOME；Spring Boot启动失败多因未加载Maven项目或误配数据源；调试乱码须在launch.json中添加UTF-8编码参数。
VSCode提示“Java Home not set”或找不到java命令怎么办
根本原因是 VSCode 的 Java 扩展（如 Extension Pack for Java）不读系统 PATH，而是依赖显式配置的 java.home。即使终端里 java -version 正常，VSCode 仍可能报错。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 先确认 JDK 安装路径：Windows 常在
C:\Program Files\Java\jdk-17.0.1，macOS 常在/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，Linux 常在/usr/lib/jvm/java-17-openjdk-amd64；用which java或echo $JAVA_HOME辅助定位，但注意：VSCode 不认JAVA_HOME环境变量，只认配置项 - 打开 VSCode 设置（Ctrl+, / Cmd+,），搜索
java.home，点击 “Edit in settings.json”，填入绝对路径，结尾不加/bin："java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
- 重启 VSCode（不是重载窗口），再看状态栏左下角是否显示 JDK 版本；若仍报错，检查路径是否存在、有无空格、是否为 JRE 而非 JDK（JDK 必须含
bin/javac）
Spring Boot 项目启动时报错 Could not find or load main class
这不是 JDK 配置问题，而是 VSCode 没识别出 Spring Boot 的启动类，或构建未触发。常见于从 ZIP 解压、Git 克隆后直接打开的项目。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 确保项目根目录下有
pom.xml（Maven）或build.gradle（Gradle），且文件内容完整（不是空模板） - 右键点击
pom.xml→ “Load Project”，等待右下角提示 “Importing Maven project…” 完成；若没反应，尝试点击 VSCode 左侧“Explorer”上方的刷新按钮（⚡图标） - 确认启动类存在且标注了
@SpringBootApplication，类名通常类似Application.java或MyApp.java；它必须在默认包或被scanBasePackages覆盖到 - 不要直接右键运行
.java文件——Spring Boot 必须通过 Maven/Gradle 构建后启动；应右键pom.xml→ “Run As” → “Maven spring-boot:run”，或终端中执行mvn spring-boot:run
运行时提示 Failed to configure a DataSource 但项目其实不需要数据库
这是 Spring Boot 自动配置的“过度推断”：只要 classpath 里有 spring-boot-starter-jdbc 或任意数据库驱动（如 HikariCP、mysql-connector-java），它就试图配数据源，哪怕你根本没写 @Repository 或 @Mapper。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 检查
pom.xml是否意外引入了数据库 starter：spring-boot-starter-jdbc、spring-boot-starter-data-jpa、mybatis-spring-boot-starter等；如果不需要，直接删掉对应<dependency> - 如果必须保留（比如后期要加 DB），就在
application.properties中显式关闭自动配置：spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
- 注意：排除后，
@EnableJpaRepositories或@MapperScan就不会生效，别误删配置类
调试时断点不命中，或控制台输出乱码（尤其是中文）
前者多因编译输出路径错乱，后者几乎全是 JVM 启动参数缺失导致的编码问题。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 检查项目设置中的
java.configuration.updateBuildConfiguration是否为"interactive"（推荐），避免 VSCode 自作主张生成错误的.vscode/settings.json覆盖 Maven 配置 - 在
.vscode/launch.json中为 Spring Boot 启动配置添加 JVM 参数："vmArgs": "-Dfile.encoding=UTF-8 -Dsun.stdout.encoding=UTF-8 -Dsun.stderr.encoding=UTF-8"
，尤其 Windows 用户必须加这行，否则日志和控制台中文全变问号 - 如果用了 Lombok，确保已安装 Lombok 扩展并启用注解处理：在设置中搜
java.configuration.runtimes，确认 JDK 版本与 Lombok 插件兼容（Lombok 1.18.30+ 支持 JDK 21）
launch.json 没配编码、或者 Maven 没手动 reload —— 这些细节不会报红，但会让整个流程静默失败。 
