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-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

立即学习“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 项目的基础前提。