Java导入自定义包时提示包不存在错误问题排查求助

DevOps 小满

2026-8-30

问题描述

编写Java程序导入自定义包时触发「包不存在（Package doesn't exists）」报错，相关代码与运行情况如下：
第一个文件（Greeting类）代码：

package com.shubham.packages.a;

import static com.shubham.packages.b.Message.Hello;

public class Greeting {
   public static void main(String[] args) {
     System.out.println("Hello World");
     Hello();
   }
}

第二个文件（Message类）代码：

package com.shubham.packages.b;

public class Message {
    public static void main(String[] args) {
      
    }
    public static void Hello() {
        System.out.println("This is Awesome.");
    }
}

运行时终端报错截图：

报错原因

这个报错的核心原因是Java编译器无法定位到你导入的com.shubham.packages.b.Message类，绝大多数情况是两个操作不规范导致的：

没有按照Java包机制的硬性要求，把声明了对应包名的源文件存放到匹配的目录层级下
编译时没有在源码根目录执行命令，编译器搜索依赖类的路径不对，找不到跨包的依赖类

Java包的匹配规则是固定的：声明了package xxx.yyy.zzz的类，必须放在文件系统路径xxx/yyy/zzz下，编译器才会按路径匹配识别包结构。如果把两个不同包的.java文件直接放在同一个文件夹里单独编译，编译器根本找不到对应包路径下的类，自然会报包不存在。
注：你的代码本身语法没有问题，静态导入静态方法的写法是符合规范的。

修复方法

按照以下步骤操作即可解决：

整理源文件目录结构
新建一个项目根文件夹，在里面按照包名建立完全匹配的目录层级，把两个源文件放到对应位置，最终结构如下：

项目根目录/
└── com/
    └── shubham/
        └── packages/
            ├── a/
            │   └── Greeting.java
            └── b/
                └── Message.java

正确编译代码
打开终端，切换到上面的项目根目录（也就是能直接看到com文件夹的层级），执行编译命令把关联的两个源文件一起编译：
javac com/shubham/packages/a/Greeting.java com/shubham/packages/b/Message.java
编译完成后，对应包路径下会自动生成Greeting.class和Message.class字节码文件。
运行主类
保持在项目根目录下，执行带完整包名的主类启动命令：
java com.shubham.packages.a.Greeting
正常运行后会输出以下结果，代表修复成功：

Hello World
This is Awesome.

如果使用IntelliJ IDEA、Eclipse这类集成开发环境写代码，只要把存放com文件夹的目录标记为源码根目录（Sources Root），IDE会自动处理包路径识别和编译逻辑，不会出现这类命令行手动编译的路径问题。

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