右键pom.xml无maven选项，说明extension pack for java和maven for java未同时安装启用；必须打开父目录作为工作区根，且maven.executable.path须指向mvn或mvn.cmd可执行文件而非目录。
右键pom.xml没出现Maven选项？先确认插件状态
VS Code 不自带 Maven 支持，所有生命周期操作都依赖插件联动。如果右键 pom.xml 看不到 “Run Maven Build” 或 “Clean”“Package” 等菜单项，基本就是插件没装全或没启用。
- 必须同时安装并启用两个插件：
Extension Pack for Java（含语言服务器）和Maven for Java（提供项目结构识别与生命周期命令） - 只装其中一个，比如只装了
Java Extension Pack，VS Code 能识别 Java 语法，但不会加载 Maven 视图、也不会注册mvn命令 - 插件启用后，打开项目根目录（不是子模块文件夹），底部状态栏应显示
Maven: Ready；若显示Maven: Not available，说明插件未生效
mvn compile 成功但 package 报 ClassNotFoundException？别急着改代码
这不是 classpath 缺失或编译失败，而是 Maven 生命周期中测试阶段干扰了打包流程。默认 package 阶段会执行 test，而某个失败的测试可能让构建中断，同时掩盖了真正的问题——比如资源未复制、主类路径配置错误，或 test-scope 依赖被误用在 main 里。
- 先运行
mvn clean compile -Dmaven.test.skip=true，确认编译层无问题 - 再运行
mvn clean package -DskipTests，跳过测试看能否生成target/*.jar - 若后者成功，检查
target/classes/下是否真有你期望的 class 文件；没有，说明sourceDirectory配置错位，或 VS Code 没把src/main/java当作源根（右键该目录 → “Add Folder to Java Build Path”） - 若仍有 ClassNotFoundException，重点查
MANIFEST.MF中的Main-Class是否拼写正确，以及是否漏配maven-jar-plugin的archive配置
多模块项目 install 后子模块仍报 Could not resolve dependency？父 pom 没真装进去
VS Code 不会自动帮你把父模块 install 到本地仓库。即使你改了子模块的 <parent></parent> 并保存了 pom.xml，只要没手动对父项目执行过 mvn install，子模块就找不到那个 xxx-1.0.0.pom。
- 确保父
pom.xml中有<packaging>pom</packaging> - 在**父项目根目录下**运行
mvn install（不是mvn compile），生成的.pom文件会落到~/.m2/repository/groupId/artifactId/version/ - 子模块的
<parent></parent>块里<version></version>必须写死（如1.0.0），不能用${project.version}—— install 时变量无法解析 - VS Code 工作区必须打开**父目录**，而不是只打开某个子模块文件夹；否则插件压根读不到父
pom.xml，自然不会触发父模块加载逻辑
settings.json 里 maven.executable.path 配错了？命令面板里跑不起来
VS Code 的命令面板（Ctrl+Shift+P → Maven: Execute Goal）和右键菜单都依赖这个路径。如果提示 Command 'mvn' not found，不是系统环境变量没配好，而是 VS Code 自己没找到 mvn 可执行文件。
- 在
settings.json（用户设置或工作区设置）中添加："maven.executable.path": "/usr/local/maven/bin/mvn"（macOS/Linux）或"maven.executable.path": "C:\apache-maven\bin\mvn.cmd"（Windows） - 路径必须指向可执行文件本身，不是目录；Windows 上一定要带
.cmd后缀，否则启动失败 - 改完设置后无需重启 VS Code，但需右键
pom.xml→ “Reload project”，否则新路径不生效 - 如果用 Homebrew 安装 Maven（macOS），路径通常是
/opt/homebrew/bin/mvn；用 SDKMAN! 的则是~/.sdkman/candidates/maven/current/bin/mvn
maven.executable.path 指向了目录而非可执行文件——这三处出错，生命周期命令根本不会出现在界面里，更别说执行了。
