VS Code需手动Reload project而非依赖保存触发；确保安装Extension Pack for Java和Apache Maven for Java；多模块项目须以父目录为工作区根并执行mvn install；跳过测试应使用-DskipTests而非-Dmaven.test.skip=true。
依赖添加后 pom.xml 保存了但 IDEA/VS Code 没反应
VS Code 本身不原生解析 Maven，靠的是 Extension Pack for Java（含 maven-extension）来监听 pom.xml 变更并触发依赖下载和索引重建。常见现象是改完 dependency 保存后，src/main/java 里仍报红、import 不识别。
- 先确认已安装并启用
Extension Pack for Java和Apache Maven for Java（二者缺一不可） - 右键
pom.xml→ 选Reload project，不是“Refresh”或手动重启窗口 - 检查 VS Code 底部状态栏是否显示
Maven: Ready；若卡在Resolving dependencies...，可能是本地仓库损坏，可删~/.m2/repository/groupId/artifactId对应目录重试 - 别依赖自动保存触发——有些插件只响应显式 reload，而非文件保存事件
mvn compile 成功但 mvn package 报 ClassNotFoundException
这通常不是编译问题，而是构建生命周期中资源未正确包含或测试干扰导致的打包异常。Maven 默认在 package 阶段执行 test，而失败的测试可能让整个构建中断并掩盖真实错误。
- 先运行
mvn clean compile -Dmaven.test.skip=true确认编译层无问题 - 再运行
mvn clean package -DskipTests跳过测试看是否能生成target/*.jar - 如果跳过测试后成功，说明是某个测试类引用了未声明的依赖，或用了
testscope 的依赖却在主代码里调用 - 检查
target/classes下是否存在预期的 class 文件；若缺失，可能是sourceDirectory配置错位，或 IDE 把src/main/java当成了普通文件夹没识别为源根
多模块项目里子模块依赖父模块，mvn install 后仍提示 Could not resolve dependency
父模块的 packaging 必须是 pom，且子模块的 parent 块需严格匹配 groupId、artifactId、version；但更常被忽略的是：VS Code 默认不会自动把父模块 install 到本地仓库，除非你明确对父 pom.xml 执行过 install。
- 确保父
pom.xml中有<packaging>pom</packaging> - 在父项目根目录下运行
mvn install（不是mvn compile），生成xxx-1.0.0.pom到~/.m2/repository - 子模块的
<parent></parent>块不能用${project.version}之类变量，必须写死版本号，否则 install 时无法解析 - VS Code 中打开的是子模块文件夹（而非整个父目录），会导致父 pom 未加载——应打开父目录作为工作区根，否则插件无法建立模块关系
想跳过 test 但 mvn package -Dmaven.test.skip=true 没用
参数名错了。-Dmaven.test.skip=true 是跳过测试编译（即不生成 target/test-classes），但依然会执行测试；真正跳过执行的是 -DskipTests。这个细节在命令行和 VS Code 终端里都一样生效。
立即学习“Java免费学习笔记（深入）”；
-
-Dmaven.test.skip=true：跳过编译测试代码（更快，但若测试代码有语法错误也不报） -
-DskipTests：编译测试代码，但不运行（推荐用于快速验证打包） - 在 VS Code 中配置任务时，别写成
"args": ["-Dmaven.test.skip=true"]，要写"args": ["-DskipTests"] - 如果项目用了
maven-surefire-plugin自定义配置，还需确认其<skiptests></skiptests>是否被硬编码为true，会覆盖命令行参数
最易被忽略的是：VS Code 的 Java 插件缓存和 Maven 本地仓库状态不同步时，reload 项目和 mvn clean 往往得做两遍——一次清插件索引，一次清 target 和仓库缓存。别省这一步。
