VSCode中Maven路径错误致mvn package失败及依赖报错的解决

1. 修正VSCode Maven扩展的可执行文件路径 #

VSCode的Maven扩展可能会优先使用项目本地配置的Maven路径，而非系统环境变量：

• 打开VSCode设置（快捷键Ctrl+,）
• 搜索框输入maven.executable.path
• 将配置值手动修改为正确路径：C:\Program Files\apache-maven-3.9.5\bin\mvn.cmd
• 保存设置后重启VSCode

2. 删除项目本地的Maven包装器配置 #

如果项目根目录存在.mvn文件夹，会强制使用项目内置的Maven版本，导致路径错误：

• 找到项目中的.mvn文件夹，直接删除整个目录
• 重新打开项目，执行mvn package命令测试

3. 刷新PowerShell环境变量缓存 #

PowerShell可能缓存了旧的环境变量，即使系统变量已更新也无法立即生效：

• 关闭所有PowerShell窗口和VSCode
• 以管理员身份打开PowerShell，执行命令：

  refreshenv
  

• 重新打开VSCode，在终端执行mvn -v，验证输出的Maven路径是否正确

4. 重置VSCode Maven扩展配置 #

针对“background process terminated with code 1”错误：

• 打开VSCode命令面板（快捷键Ctrl+Shift+P）
• 输入Maven: Reset Maven Configuration并执行
• 执行完成后，通过命令面板选择Reload Window重新加载窗口

5. 再次确认系统环境变量配置 #

确保系统层面的Maven环境变量配置无误：

• 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”
• 系统变量中：
  • 确认MAVEN_HOME的值为C:\Program Files\apache-maven-3.9.5
  • 确认Path变量中包含%MAVEN_HOME%\bin，且该条目位于其他可能的Maven路径之前
• 保存配置后重启电脑，确保环境变量完全生效

内容的提问来源于stack exchange，提问作者Kit