tasks.json配置必须严格匹配JDK版本和项目结构：Java项目需根据Maven或纯文件夹选择对应命令（mvn compile或javac加-sourcepath/-d），JDK 17+需--add-modules，preLaunchTask必须与label完全一致，-d参数须正确指定输出目录以匹配包结构。
tasks.json 配置必须匹配 JDK 版本和项目结构
VSCode 的 Java 编译依赖 tasks.json 中定义的 javac 命令，但直接写 javac 很容易失败——它不自动识别 src/main/java 下的包路径，也不处理模块路径或多源文件依赖。
- 如果你用 Maven 项目，
tasks.json不该调用裸javac，而应指向mvn compile或mvn -Dmaven.test.skip=true compile - 纯 Java 文件夹项目（无
pom.xml），需显式指定-sourcepath和-d输出目录，例如：javac -sourcepath src -d bin src/com/example/HelloWorld.java - JDK 17+ 默认启用模块系统，若项目没
module-info.java，要加--add-modules ALL-SYSTEM，否则可能报package java.util does not exist
“preLaunchTask” 在 launch.json 中必须与 tasks.json 的 label 完全一致
调试时点击绿色三角形或按 F5，VSCode 会先执行 preLaunchTask。这个字段不是随便起名的，它必须严格等于 tasks.json 里某个 task 的 label 字符串，包括大小写和空格。
- 常见错误：
tasks.json中写"label": "Build Java"，但launch.json里写"preLaunchTask": "build java"→ 任务不会触发，直接报错PreLaunchTask "build java" cannot be found - 建议统一用小写字母 + 连字符，比如
"label": "compile-java"，避免空格和大小写混淆 - 如果
preLaunchTask指向不存在的 label，VSCode 不会提示语法错误，只在调试启动时静默失败
自动编译失效？检查 file watcher 是否被禁用或路径不匹配
很多人设了 "files.autoSave": "onFocusChange" 并配置了保存时运行 task，却发现改完代码一保存，终端没反应——问题常出在 task 的 isBackground 和 problemMatcher 上。
-
"isBackground": true必须配合有效的problemMatcher（如"$javac"），否则 VSCode 认为 task “没结束”，后续保存会被阻塞 - task 的
"args"里若用"${file}"，只对当前打开的单个文件生效；想编译整个src目录，得改成"src/**/*.java"（注意 shell 是否支持 glob） - Windows 上 cmd 默认不展开
**，要用PowerShell作为command，或改用javac -sourcepath src -d bin $(Get-ChildItem src -Recurse -Filter *.java | ForEach-Object {$_.FullName})
输出 class 文件位置混乱？别依赖默认行为
javac 默认把 .class 放在和 .java 同级目录，但 Java 运行时需要按包结构找类。VSCode 不会自动帮你重建目录树，-d 参数漏设或设错，就会导致 NoClassDefFoundError 或 ClassNotFoundException。
- 正确做法：始终显式指定
-d，且目标目录要和包声明匹配。例如package com.example;对应的.java在src/com/example/HelloWorld.java，则-d应指向bin，编译后bin/com/example/HelloWorld.class才能被正确加载 - 不要把
-d设成.或./，这会导致 class 文件散落在各处，后续java -cp . com.example.HelloWorld会失败 - 如果用了 Maven，
target/classes是标准输出位置，tasks.json中的args应保持与mvn compile一致，避免手动编译和 Maven 编译输出混杂
真正麻烦的不是写几行 JSON，而是每个路径、每个 flag、每个 label 都得对齐 JDK 行为、VSCode 解析逻辑和项目实际结构——少一个斜杠，就可能卡在 classpath 里出不来。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
