VSCode调试Java多模块项目需确保projectName精确匹配模块名并手动Reload Project。projectName决定classpath包含哪些模块，Reload使JDT.LS加载最新pom.xml结构；二者缺一不可，否则出现断点失效、类找不到等问题。
VSCode 本身不执行 Maven 构建，它靠插件解析 pom.xml 获取项目结构、依赖和编译参数，再交由 Java Debug Server 启动 JVM 进程——所以“自动化构建调试”的本质，是让 VSCode 正确加载模块、生成 classpath、并把修改实时反映到调试中。配置错一个环节，就会出现断点不生效、类找不到、改了代码还是旧逻辑等问题。
确保 Maven 可执行路径和 settings.xml 一致
VSCode 的 Maven 插件（Maven for Java）和语言服务器（JDT LS）各自读取 Maven 配置，但默认行为不联动：
-
maven.executable.path必须显式指向真实可执行文件（Windows 用mvn.cmd，macOS/Linux 用mvn或./mvnw）；若项目根目录有mvnw，推荐设为"./mvnw"并确保执行权限（macOS/Linux 执行chmod +x mvnw） -
java.configuration.maven.userSettings和maven.settingsFile必须指向同一个settings.xml文件，否则镜像、私仓认证、本地仓库路径等配置在构建时生效，但在 VSCode 解析依赖时被忽略 - 如果使用多个 Maven 版本或 CI/CD 中的 wrapper，不显式配置会导致“依赖下载成功但 VSCode 标红”或“调试时
NoClassDefFoundError”
多模块项目必须手动触发 Reload Project
VSCode 不监听 pom.xml 变更自动重载项目模型，尤其在 parent + submodules 结构下，新增模块、改 <scope>provided</scope>、加 profile 后，语言服务器仍按旧快照工作：
- 右键项目根目录下的
pom.xml→ 选择 “Reload project”（不是 “Update project”，那是 Eclipse 概念，VSCode 不识别） - 如果模块没出现在侧边栏 “JAVA PROJECTS” 列表里，或子模块的
src/main/java没被识别为源码根目录，Reload 是唯一有效手段 - 大型项目 Reload 耗时较长，期间不要操作 launch.json 或启动调试，否则可能加载不完整模型
launch.json 中的 projectName 必须精确匹配模块名
VSCode 调试器不会自动推导主类所在模块，projectName 字段直接决定 classpath 包含哪些模块的 target/classes 和依赖：
- 错误写法：
"projectName": "mall-parent"—— 父 POM 模块通常不含代码，启动必报Could not find or load main class - 正确写法：
"projectName": "mall-web"（假设启动类在mall-web模块），且该模块需在 JAVA PROJECTS 中可见 - 若模块名含特殊字符（如
my-app-service），projectName必须与pom.xml中的<artifactid></artifactid>完全一致，大小写敏感 - 不填
projectName时，VSCode 默认只加载当前打开文件所在模块，多模块场景下极易漏依赖
改代码后不生效？检查 java.configuration.updateBuildConfiguration
VSCode 默认只做语义解析，不主动触发 Maven 编译。即使你改了 mall-common 里的工具类，mall-web 调试时加载的仍是上次构建的旧 class：
- 在
.vscode/settings.json中添加："java.configuration.updateBuildConfiguration": "automatic" - 该配置会让 JDT LS 在保存 Java 文件后，自动调用 Maven 编译对应模块的
src/main/java，更新target/classes - 注意：它不会运行
mvn clean，也不会编译src/test/java；若需彻底刷新，仍要手动执行Maven: Compile命令 - 该选项对 CPU 和磁盘 I/O 有轻微开销，仅建议开发阶段开启，CI 流水线中应禁用
最常被忽略的是 projectName 和 Reload project 的配合：模块名写错，Reload 多次也没用；Reload 没做，projectName 再准也加载不到新模块。这两步必须一起验证，缺一不可。
