Java 不支持真正的嵌套包，声明时只需一个 package 语句，且必须写全路径（如 package com.example.util;），而非分段或多次声明。
java 不支持真正的嵌套包，声明时只需一个 `package` 语句，且必须写全路径（如 `package com.example.util;`），而非分段或多次声明。
在 Java 中，包（package）是用于组织类和提供命名空间隔离的核心机制。开发者常误以为存在“嵌套包”（nested packages）的概念——例如将 com.example.service 视为 com.example 的子包。但需明确：Java 语言规范中并不存在嵌套包这一概念。com.example、com.example.service 和 com.example.service.impl 在编译器眼中是三个完全独立、彼此无继承或包含关系的包。
因此，声明包时必须且只能使用一个 package 语句，其值为该类所在目录结构对应的完整限定名（fully qualified package name），各层级用英文点号（.）连接，不可省略任何中间段，也不可拆分为多个 package 声明。
✅ 正确示例：
假设项目结构如下：
src/
└── com/
└── example/
└── service/
└── UserService.java则 UserService.java 的首行必须为：
package com.example.service;
❌ 常见错误写法（均非法）：
立即学习“Java免费学习笔记（深入）”；
// 错误1：只写最后一级（缺少路径上下文） package service; // 错误2：分两次声明（语法错误，编译失败） package com.example; package service; // 错误3：使用连字符（非法标识符） package com.example-service; // 编译报错：invalid identifier
⚠️ 重要注意事项：
- 包可见性不传递：package-private（即默认访问修饰符）成员仅对同名包内的类可见，com.example.service 中的 package-private 方法对 com.example 或 com.example.service.impl 中的类不可见。
- 目录结构必须严格匹配：源文件必须位于与包名对应的子目录中（如 package com.example.service; → 文件必须位于 com/example/service/ 目录下），否则编译器将报错 class file does not match location。
- IDE 通常自动同步：现代 IDE（如 IntelliJ IDEA、Eclipse）在新建类时会根据所在目录自动生成正确的 package 语句，但仍需人工核对，尤其在重构包结构后。
总结而言，Java 包的本质是扁平化的命名空间，所谓“嵌套”仅体现为命名约定与文件系统层次的一致性。掌握“单语句 + 全路径”的声明原则，是编写可维护、可编译 Java 项目的基础前提。
