VSCode中Maven项目运行HelloWorld遇java.lang.NoClassDefFoundError错误求助

错误核心原因 #

你遇到的Error: Could not find or load main class Saludo和wrong name: Saludo，本质是类的包声明与运行时的目录结构、命令不匹配：你的类声明了package bmt;，意味着编译后的.class文件必须位于bmt目录下，且运行时必须从包含bmt目录的上级目录执行命令，同时指定完整的包名+类名。

一、Maven项目解决方案 #

1. 确认目录结构合规 #

Maven要求源码必须放在src/main/java下对应包名的子目录里。你的Saludo.java必须放在如下结构中：

你的项目根目录
└── src
    └── main
        └── java
            └── bmt
                └── Saludo.java

不能直接把Saludo.java放在src/main/java根目录。

2. 用Maven命令编译运行 #

在项目根目录（包含pom.xml的目录）执行以下命令：

• 编译项目：

  mvn compile
  

• 直接运行主类（需指定完整包名）：

  mvn exec:java -Dexec.mainClass="bmt.Saludo"
  

• 打包后运行（需在pom.xml中配置主类入口）：
  先执行打包：

  mvn package
  

  然后运行生成的jar包：

  java -jar target/你的项目名-版本号.jar
  

  （pom.xml中配置主类的示例：在<build>标签内添加）

  <plugins>
      <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-jar-plugin</artifactId>
          <version>3.3.0</version>
          <configuration>
              <archive>
                  <manifest>
                      <mainClass>bmt.Saludo</mainClass>
                  </manifest>
              </archive>
          </configuration>
      </plugin>
  </plugins>
  

二、普通Java程序（非Maven）解决方案 #

1. 正确的编译运行步骤 #

假设你的Saludo.java在当前目录的bmt子目录中：

• 编译：

  javac bmt/Saludo.java
  

  编译后bmt目录会生成Saludo.class文件。
• 运行（必须回到bmt的上级目录执行）：

  java bmt.Saludo
  

  ❌ 错误操作：进入bmt目录执行java Saludo，会直接触发wrong name错误。

三、CLASSPATH问题修复 #

手动设置系统CLASSPATH后如果未包含当前目录（.），会导致所有Java程序找不到类：

• 直接删除系统环境变量中的CLASSPATH（Java 1.6及以上版本默认会将当前目录加入类路径）；
• 若必须保留CLASSPATH，确保其值包含.（例如.;其他必要路径）。

内容的提问来源于stack exchange，提问作者Luisa Londoño