vscode必须手动配置jdk和maven路径：通过“java: configure java runtime”添加jdk根目录（非bin/jre），设maven.executable.path指向mvn/mvn.cmd文件，右键pom.xml选“import to workspace”并执行“update project”方可启用完整java支持。
VSCode 不会自动识别你装好的 JDK，必须手动告诉它路径在哪里；否则即使 java -version 和 mvn -v 在终端里能跑，VSCode 依然报红、没提示、编译失败。
Java: Configure Java Runtime 比 java.home 更可靠
VSCode 的 Java 扩展优先读取 “Java: Configure Java Runtime” 里配置的 JDK 列表，而不是单纯依赖 java.home 或系统 JAVA_HOME。尤其在多 JDK 环境下，硬写 "java.home": "C://jdk-17" 容易被覆盖或失效。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Java: Configure Java Runtime - 在 “JDKs” 标签页点击 +
Add JDK，直接浏览到 JDK 根目录（如C:\Program Files\Java\jdk-17.0.2或/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home），不要选bin子目录，也不要选jre - 确认后，状态栏右下角应显示类似
17或21的 JDK 版本号；若仍显示Not found，说明路径错或权限不足（macOS/Linux 注意ls -ld检查目录可读）
maven.executable.path 必须指向 mvn 或 mvn.cmd 文件本身
VSCode 的 Maven 插件默认尝试调用 mvn 命令，但不会自动从 PATH 查找——它需要明确的可执行文件路径。设成 MAVEN_HOME 目录或 bin 目录都会失败。
- 先在终端运行
which mvn（macOS/Linux）或where mvn（Windows），确认实际路径，例如：/opt/homebrew/bin/mvn、C:\apache-maven-3.9.6\bin\mvn.cmd - 打开 VSCode 设置（
Ctrl+,），搜索maven.executable.path，点击 “Edit in settings.json”，填入完整路径："maven.executable.path": "/opt/homebrew/bin/mvn" - 如果用 SDKMAN，路径通常是
~/.sdkman/candidates/maven/current/bin/mvn；Windows 用户注意用正斜杠或双反斜杠，避免转义问题 - 配完后重启 VSCode，再打开含
pom.xml的文件夹，左下角应出现Maven Projects面板，点刷新能看到模块和生命周期命令
导入 Maven 项目不是“打开文件夹”就完事
只把项目文件夹拖进 VSCode，pom.xml 不会被自动解析，IntelliSense 无法识别依赖类（比如 import org.springframework.web.bind.annotation.RestController 标红），但 mvn compile 命令行却可能成功——这是典型“VSCode 没导入，只当普通文本文件处理”的表现。
- 右键点击项目根目录下的
pom.xml文件，选择Import to Workspace（不是 “Open with…” 或 “Load Project”） - 等待右下角提示 “Importing Maven project…” 完成；若没反应，尝试点击 VSCode 左侧 “Explorer” 上方的刷新按钮（⚡图标）
- 导入成功后，
src/main/java下的类才能获得完整语法支持，依赖包才出现在Referenced Libraries中 - Spring Boot 启动类需标注
@SpringBootApplication，且必须在默认包或被scanBasePackages覆盖到，否则Run As → Maven spring-boot:run会找不到主类
运行时提示 Failed to configure a DataSource 却不需要数据库
这是 Spring Boot 自动配置的“过度推断”：只要 classpath 里有 spring-boot-starter-jdbc 或任意数据库驱动（如 HikariCP、mysql-connector-java），它就试图配数据源，哪怕你根本没写 @Repository 或 @Mapper。
- 检查
pom.xml是否误引入了数据库相关 starter，比如spring-boot-starter-data-jpa、mybatis-spring-boot-starter - 若确定不需要，直接删掉对应依赖；若只是临时跳过，可在
application.properties加：spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration - 注意：这个错误和 JDK/Maven 配置无关，但常被误判为环境问题，浪费大量排查时间
最易忽略的一点是：所有路径都必须指向 JDK 根目录（含 bin、lib、jre 的那个文件夹），而非 bin 或 jre 子目录；且每次改完设置后必须重启 VSCode，重载窗口无效。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
