Java通过包（package）实现命名空间功能，要求包声明与目录结构严格匹配、禁用默认包、谨慎使用import和静态导入以避免冲突。
Java 中没有“命名空间”这个术语，但包（package）机制完全承担了命名空间的功能：它通过全限定名（包名 + 类名）实现类的唯一标识与天然隔离。正确导入和组织包结构，核心在于让编译器能无歧义地定位类，同时避免隐性冲突。
包声明必须匹配目录结构
每个 Java 源文件顶部的 package 语句不是可选注释，而是强制约定：
- 必须是文件中第一条非注释语句
- 包名全部小写，推荐采用反向域名 + 业务分层，如 com.example.ecommerce.order.dto
- 源码路径必须严格对应包名层级：类 com.example.ecommerce.order.dto.OrderDto 必须存放在 com/example/ecommerce/order/dto/OrderDto.java
- 不声明 package 的类属于“默认包”，禁止在正式项目中使用——它无法被其他包 import，也不支持访问控制
import 是编译期辅助，不是运行时依赖
import 语句只影响源码编写时的类名简化，不改变字节码或类加载行为：
- 导入后可用简单名（如 ArrayList），否则必须写全限定名（java.util.ArrayList）
- 同名类共存时（如自定义 Menu 和 java.awt.Menu），仅靠 import 无法消歧；必须显式用全限定名调用，或确保只导入目标类
- 避免通配符导入（import java.util.*;）与自定义同名类并存——编译器可能误选，导致 “cannot resolve method” 错误
用包结构解决真实冲突场景
当出现 “找不到方法” 或 “类型不匹配” 时，大概率是类名被标准库或其他模块覆盖：
立即学习“Java免费学习笔记（深入）”；
- 检查是否遗漏了自定义类的 package 声明（比如 Menu.java 没有 package com.example.restaurant;）
- 在调用方确认 import 是否指向正确路径：import com.example.restaurant.Menu;，而非未声明包的默认位置
- 若仍报错，直接用全限定名验证：new com.example.restaurant.Menu().getStarters(); —— 成功则说明 import 配置有误
- 构建工具（如 Maven）中可通过 maven-enforcer-plugin 禁止跨域包直连，倒逼接口抽象与模块边界清晰
静态导入要克制，只用于明确、高频、无歧义的成员
静态导入（import static）不是简化代码的捷径，而是表达意图的信号：
- 适合导入来源单一、用途固定的常量或工具方法，如 import static org.junit.jupiter.api.Assertions.assertEquals;
- 禁止导入多个类中同名的静态方法（如两个 StringUtils.isEmpty()），编译直接失败
- 业务主逻辑中慎用；实体类、DTO、配置类中禁用——它们应保持纯数据性，不耦合行为
- IDE 能高亮显示静态方法来源，但团队协作时建议首次使用处加简短注释，例如 // from com.example.util.DateUtils
