声明的包"a"与预期包""不匹配及Java类加载失败问题咨询

文件结构 #

folder "a"
        |
        |_____ MyClass.java

MyClass.java 代码内容 #

package a;

public class MyClass {
    public static void main(String[] args) {
        System.out.println("Hello world");

    }
}

出现的错误 #

IDE提示错误 #

The declared package "a" does not match the expected package "".

编译运行时错误 #

Error: Could not find or load main class MyClass
Caused by: java.lang.NoClassDefFoundError: a/MyClass (wrong name: MyClass)

问题根源 #

• IDE目录识别偏差：VS Code处理Java包结构时，要求把a文件夹的父目录作为项目根目录。如果直接打开a文件夹本身，IDE会默认当前目录是根目录，没有包层级，所以会提示包声明和预期不符。重新打开文件夹时，IDE偶尔会自动纠正根目录的识别，但并非每次都能成功，导致问题时好时坏。
• 编译运行路径错误：编译和运行Java类必须从包的根目录（即a的父目录）操作。如果在a文件夹内直接编译，生成的字节码文件会被放在当前目录，JVM运行时会认为这个类属于默认包，但代码里明确声明了属于包a，就会出现找不到主类或者包名不匹配的错误。

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