Java子包存在同名类时如何正确引用作为方法参数的类

你遇到的报错是因为Java的包机制不存在「父包中可直接省略父包前缀引用子包」的规则，你在pkg1包下直接写subpkg1.SomeClass时，编译器会将subpkg1识别为顶级包，而非pkg1的子包，因此找不到对应类。

解决方案1：全版本兼容方案（推荐） #

直接使用子包类的全限定名即可，当前包下的同名类不需要额外导入，直接用类名引用。

修改后的LastClass代码如下：

package pkg1;

public class LastClass {
    // 直接用类名，默认引用当前包下的pkg1.SomeClass
    public void someMethod(SomeClass someClass) {
    }

    // 写全限定名引用子包类
    public void someOtherMethod(pkg1.subpkg1.SomeClass someClass) {
    }
}

解决方案2：Java 22+ 简化写法 #

如果你使用的是Java 22及以上版本，可以通过导入别名的方式避免每次写全限定名：

package pkg1;

// 导入子包的同名类并指定别名
import pkg1.subpkg1.SomeClass as SubSomeClass;

public class LastClass {
    public void someMethod(SomeClass someClass) {
    }

    // 直接用别名引用即可
    public void someOtherMethod(SubSomeClass someClass) {
    }
}

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