Java 不支持真正的嵌套包，所有带点号分隔的包名（如 com.example.util）都是独立的顶层包；声明时必须使用完整路径，且仅允许一个 package 语句。
java 不支持真正的嵌套包，所有带点号分隔的包名（如 `com.example.util`）都是独立的顶层包；声明时必须使用完整路径，且仅允许一个 `package` 语句。
在 Java 中，包（package）的本质是命名空间的层级化组织方式，而非语法层面的嵌套结构。当你在文件系统中看到类似 src/main/java/com/example/service/UserService.java 的路径时，对应的 Java 源文件必须以一条且仅一条 package 声明开头，其值为该类逻辑归属的完整限定名（fully qualified package name），即路径中 src/main/java/ 之后、.java 之前的部分，用英文句点 . 连接：
// 正确：声明完整包路径 package com.example.service;
✅ 正确示例
假设项目结构如下：
src/
└── main/
└── java/
└── org/
└── myapp/
└── core/
└── DatabaseManager.java则 DatabaseManager.java 的首行必须为：
package org.myapp.core;
❌ 常见错误写法（均非法）：
// 错误1：拆分成多个 package 语句（编译失败） package org; package myapp; package core; // 错误2：只写最后一级（导致类实际属于错误包） package core; // 错误3：使用短横线（-）或引号（Java 包名不支持特殊字符和字符串字面量） package "org.myapp.core"; // 编译错误：unexpected token package org-myapp-core; // 编译错误：invalid identifier
⚠️ 关键注意事项：
立即学习“Java免费学习笔记（深入）”；
- Java 无“嵌套包”概念：org.myapp、org.myapp.core 和 org.myapp.core.db 在语言层面互不隶属，彼此完全独立。它们之间不存在继承关系或作用域穿透。
- 包访问权限（package-private）不跨级生效：一个 default（包级）修饰的类或成员，仅对同名包内的其他类可见，org.myapp.core 中的默认成员对 org.myapp.service 中的类不可见，即使路径看似“相邻”。
- 目录结构必须严格匹配包名：编译器和 JVM 依赖 classpath 下的目录层级解析包——若声明 package a.b.c;，则 .class 文件必须位于 a/b/c/ 子目录中，否则运行时报 NoClassDefFoundError。
? 最佳实践建议：
- 始终采用反向域名约定（如 io.github.username.project）保证全局唯一性；
- 避免过度深层嵌套（如 com.a.b.c.d.e.f），通常 3–4 级已足够表达模块层次；
- 利用 IDE（IntelliJ / Eclipse）自动同步包声明与文件位置，减少手动出错。
简言之：一个类 → 一个 package 语句 → 一个完整点分包名 → 一个严格对应的目录路径。这是 Java 包机制的基石，也是构建可维护、可定位、可协作项目的前提。
