如何在Java中创建子包？

在Java中创建子包是组织代码结构的基础操作,本质是通过目录层级嵌套实现，以下是详细步骤和注意事项：

手动创建子包（文件系统操作）

1. 定位父包目录
   假设父包名为 com.example，对应文件系统路径为：
   项目根目录/src/com/example（Maven项目通常在 src/main/java/com/example）

2. 创建子包目录
   在父包目录下新建文件夹，名称即子包名。

   • 创建子包 util → 新建文件夹 util
   • 完整路径：src/main/java/com/example/util

3. 目录结构示例

   src/main/java
   └── com
       └── example        (父包)
           └── util      (子包)
               └── StringUtils.java  (子包中的类)

在IDE中创建子包（以IntelliJ IDEA为例）

1. 右键父包
   在项目视图中右键点击父包（如 com.example）。
2. 新建子包
   选择 New → Package，输入子包名（如 util）。
   注意：IDE会自动生成完整包名 com.example.util。
3. 验证结构
   检查目录是否生成：com/example/util

其他IDE操作：

• Eclipse：右键父包 → New → Package → 输入 util（自动继承父包路径）。
• VS Code：在资源管理器手动创建文件夹，或使用Java扩展插件。

代码中使用子包

1. 在子包中创建类
   在子包 util 中创建 StringUtils.java，首行声明包路径：

   package com.example.util; // 子包声明
   public class StringUtils {
       public static boolean isEmpty(String str) {
           return str == null || str.trim().isEmpty();
       }
   }

2. 在其他包中调用子包类
   通过全限定名或import导入使用：

   package com.example.main;
   import com.example.util.StringUtils; // 导入子包中的类
   public class Main {
       public static void main(String[] args) {
           System.out.println(StringUtils.isEmpty("")); // 输出 true
       }
   }

关键注意事项

1. 包名规范

   • 全部小写字母,避免使用特殊符号或关键字（如 int, class）。
   • 域名反写约定：公司域名倒序（如 com.google）。

2. 目录与包名的强制关联
   Java要求物理目录结构必须与包名严格匹配。
   错误示例：包声明 package com.example.util; 但类文件放在 com/example/utils 目录下。

3. 避免包名冲突
   子包与父包无继承关系，仅是逻辑层级。
   java.util 和 java.util.concurrent 是两个独立的包。

常见问题解决

• 编译错误 “cannot find symbol”
  检查子包目录是否缺失，或 import 路径是否拼写错误。

• IDE未识别子包
  刷新项目：IDEA中右键项目 → Reload from Disk；Eclipse中按 F5。

• 跨子包访问权限
  子包中的类需声明为 public 才能被其他包访问，默认（无修饰符）仅限同包内使用。

引用说明基于Oracle官方Java规范[^1]及IDE操作文档[^2][^3]整理，遵循Java目录结构标准，实践中请确保包名与文件路径一致，这是Java编译和运行的基础要求。

[^1]: Oracle. “Packages in Java”. Java Documentation.
[^2]: JetBrains. “Creating Java Packages”. IntelliJ IDEA Help.
[^3]: Eclipse Foundation. “Working with Java Packages”. Eclipse IDE User Guide.