vscode报“java runtime not found”说明系统jdk正常但vscode未识别，必须手动配置java.home指向完整jdk根目录（非bin/jre），保存后彻底重启vscode，否则插件仍加载旧缓存。
java -version 能跑，但 VSCode 里报“Java runtime not found”
说明系统级 JDK 已装好，但 VSCode 没读到或读错了路径。它不完全信任 JAVA_HOME，尤其在多 JDK 共存、或用非标准路径安装（如解压版 Temurin）时更明显。
最稳的解法是直接在 VSCode 的 settings.json 里硬编码 java.home：
- 按
Ctrl+,打开设置 → 右上角点击「打开设置 (JSON)」图标 - 添加一行：
"java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.2-hotspot"（Windows 示例，路径必须是实际 JDK 根目录，不含in） - macOS/Linux 路径示例：
"java.home": "/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home" - 改完保存，重启 VSCode —— 不要只重载窗口，整个进程得重启才生效
别碰 java.configuration.runtimes，那是给多版本切换用的，新手容易配错反而触发冲突。
装了 Extension Pack for Java，但右键 Run 还是灰色
常见原因是没识别出 Java 项目结构。VSCode 不像 IDE 那样自动建工程，它靠文件特征判断：要么有 .java 文件 + 正确的包声明，要么有 pom.xml 或 build.gradle。
快速验证是否被识别为 Java 项目：
- 打开一个
.java文件，看左下角状态栏是否显示 Java 版本号（如17） - 如果没有，检查该文件第一行是不是
package xxx;；空包也得写package ;，否则会被当脚本处理 - 如果只是单个文件没包声明，右键依然不能 Run —— 这是设计如此，不是 bug
- 临时救急：终端进文件所在目录，手动执行
javac App.java && java App
别依赖「Run Without Debugging」按钮，它只对已识别的 Java 项目生效；单文件调试请用「Debug Java」启动配置。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
mvn clean package 报错 “No compiler is provided”
这是 Maven 找不到 javac，根本原因几乎全是 maven.executable.path 指向了错误的可执行文件。
Windows 用户尤其注意：
- 不要设成
mvn.bat或mvn.cmd—— VSCode 的 Maven 插件需要调用 shell 脚本，而 Windows 的 .cmd 在某些终端里会卡住 - 正确路径应是
"maven.executable.path": "C:\apache-maven-3.9.6\bin\mvn"（无后缀，让插件自己选 shell） - 同时确认
maven.terminal.customEnv里JAVA_HOME值和java.home一致，否则 Maven 生命周期执行时可能用错 JDK - 如果用了阿里云镜像，确保
settings.xml放在conf目录下，并在 VSCode 设置中用java.configuration.maven.userSettings显式指向它
这个错误和 VSCode 界面无关，是 Maven 自身运行环境问题，所以即使插件图标亮着，命令照样失败。
Debug 启动时报 “Could not find or load main class”
不是类名写错，而是 VSCode 默认用「当前工作目录」去加载 classpath，而它往往不是你期望的模块根目录。
关键点在于 launch.json 的 cwd 字段：
- 如果项目是 Maven 结构，
cwd应设为含pom.xml的目录，例如"cwd": "${workspaceFolder}" - 如果只是单个
App.java，且编译后.class在同目录，cwd就得是那个文件所在目录，不能是 workspace 根 - 别省略
mainClass字段，哪怕类在默认包里也要写全，比如"mainClass": "App"，不能写"App.class"或带路径 - 检查
sourcePaths和classPaths是否被插件自动生成覆盖 —— 有自定义需求时，宁可删掉它们让插件重新推导，也不要手动填错
这个报错看起来像编译问题，实际 90% 是运行时 classpath 和工作目录错位导致的，盯着 cwd 和 mainClass 就够了。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
