Java包的定义与包导入的基本语法_技术教程

Java中package声明必须是源文件第一行非注释语句，其前只能有空白符和文档注释；包名全小写、路径与文件系统严格对应；默认包不可被命名包引用；import须在package后、类前，推荐显式导入。

Java中package声明必须是源文件第一行非注释语句

如果在package语句前写了任何代码（包括空行、import、类定义、甚至单行注释//），编译器会直接报错：class, interface, or enum expected。这是初学者最常踩的坑。

正确写法必须严格满足：文件顶部只有空白符和文档注释/** ... */，紧接着就是package语句：

/**
 * 工具类包说明
 */
package com.example.utils;
import java.util.List;
public class StringUtils {
// ...
}

package语句不能出现在类内部或方法中
一个Java源文件最多只能有一个package语句
包名必须全部小写，避免与类名冲突（如java.lang.String中的String是类，lang是包）

import语句位置和通配符使用的实际影响

import必须紧跟在package之后、类定义之前。它只是告诉编译器“这个类名在哪个包里”，不加载类、不触发初始化、也不影响运行时性能。

使用import java.util.*;看似方便，但可能引发命名冲突（比如同时用到ja

va.sql.Date和java.util.Date），且降低可读性——别人无法一眼看出你到底用了哪些类。

推荐显式导入：例如import java.util.ArrayList;、import java.util.HashMap;
静态导入（import static）要更谨慎，仅用于频繁调用的静态成员，如import static org.junit.Assert.assertEquals;
IDE自动优化（如IntelliJ的“Optimize Imports”）能帮你清理未使用的import，但不会帮你判断语义合理性

默认包（无package声明）导致的跨文件引用失败

如果一个Java文件没写package语句，它就属于“默认包”。此时其他有明确包名的类**无法通过import引用它**，编译器会报错：package does not exist或cannot find symbol。

这不是权限问题，而是Java语言规范强制要求：默认包中的类不能被命名包中的类直接访问。哪怕两个文件在同一目录下，也不行。

解决方式只有两个：给默认包的文件加上package声明（如package demo;），或把所有相关类都放进默认包（不推荐，仅限极简测试）
Maven/Gradle项目中，默认包几乎必然导致构建失败，因为模块路径（module path）和类路径（classpath）机制不支持默认包混用
从Java 9起，模块系统彻底禁止默认包参与模块化，所以只要用module-info.java，就必须为所有类指定包

包路径与文件系统路径必须严格一致

Java要求package com.example.core对应的源文件，必须放在com/example/core/子目录下。如果放错位置（比如放在src/根目录），即使编译能过（某些旧版javac容忍），运行时也会抛出NoClassDefFoundError或ClassNotFoundException。

这个规则对大小写也敏感——Windows上可能“凑巧”运行成功，但在Linux/macOS服务器上必挂。