根本原因是JVM启动上下文未对齐：Java调试器需先通过projectName识别模块、拼装classpath，再注入args/env；若projectName错误、语言服务器未完整加载多模块、preLaunchTask未触发编译或cwd路径错位，参数将完全不生效。
launch.json 里 args 或 env 不生效，根本原因是 JVM 启动上下文没对齐
VSCode 的 Java 调试器不会无脑把 args 和 env 塞进 JVM 启动命令——它先查 projectName，再根据该模块的 Maven 构建输出目录拼 classpath，最后才组装参数。如果 projectName 错了、或者模块压根没被语言服务器识别，那 args 就像写在空气里：调试器根本没走到真正启动 JVM 那一步。
常见表现：
-
args: ["--spring.profiles.active=dev"]写了但Environment.getActiveProfiles()还是空 -
env: { "JAVA_HOME": "/opt/java17" }设了，但System.getProperty("java.home")仍是默认 JDK - 控制台打印出的启动命令里压根没出现你写的
args或环境变量
验证方法：在 launch.json 中加一行 "console": "integratedTerminal"，启动时看终端输出的真实 java -cp ... 命令，确认参数是否出现在末尾。
Java 语言服务器未完成导入，projectName 查不到就自动 fallback 到单模块逻辑
VSCode 的 Java 扩展依赖 Language Server 加载整个多模块结构。如果它只加载了部分模块（比如只看到 web 模块，漏了 common），那你在 launch.json 里写的 "projectName": "myapp-web" 就会失效——语言服务器查不到这个项目名，转而用当前文件所在目录的 classpath 启动，结果就是 classpath 缺失、args 和 env 全部作废。
必须检查的三个信号：
- 左侧 JAVA PROJECTS 视图中是否完整列出父 POM 和所有子模块
- 状态栏右下角是否显示
Maven Projects: Ready（不是 “Loading” 或空白） - 在根目录执行
mvn compile成功后，各模块的target/classes目录是否非空
若不满足，先在 Maven 面板点击 Reload project，或手动运行 mvn clean compile -DskipTests 再刷新。
preLaunchTask 没配或执行失败，导致 classpath 里全是旧 class
VSCode 默认不会在每次调试前自动编译整个多模块工程。如果你改了 common 模块的代码，但没配置 preLaunchTask，调试器就会拿着三天前的 common/target/classes 启动 web 模块——这时哪怕 args 和 env 全对，也会因为类版本不匹配、静态字段未更新、配置类缺失等底层问题，让参数“看起来没生效”。
正确配置要点：
- 在
.vscode/tasks.json中定义一个 Maven 编译任务，group设为"build"，isBackground设为false - 在
launch.json中引用它："preLaunchTask": "maven compile"（任务 label 名） - 确保该任务执行后，所有依赖模块的
target/classes时间戳都更新了
别用 mvn spring-boot:run 当 preLaunchTask——它不生成标准 classpath，调试器无法复用其输出。
调试器启动目录（cwd）错位，导致配置文件和资源路径失效
Spring Boot 默认从 classpath:/ 加载 application.yml，但这个 classpath 的根取决于 JVM 启动时的当前工作目录（cwd）。如果 launch.json 里没设 "cwd": "${workspaceFolder}/myapp-web"，调试器可能在根目录或某个子模块里启动，结果就是 application-dev.yml 找不到、static/ 资源 404、甚至 @Value("${custom.prop}") 解析为空。
关键判断点：
- 报错日志里是否出现
Failed to load config data location 'classpath:/application-dev.yml' - 在启动类里加一行
System.out.println(new File(".").getAbsolutePath());，确认实际cwd -
cwd必须指向包含src/main/resources的模块目录，不能是父工程根目录
多模块项目中，cwd 错位是最隐蔽的“参数失效”原因——它不报错，只是让所有基于路径的配置全部脱钩。
