Java中包声明必须是源文件第一行非注释语句,且一个文件只能有一个package;import语句紧随其后,不能在类内部或方法里出现。

Java中包声明必须是源文件第一行非注释语句,且一个文件只能有一个package;import语句紧随其后,不能在类内部或方法里出现。
包声明必须放在文件最顶部
很多初学者把package写在import之后,或者加了空行、文档注释(/** */)在它前面,这会导致编译失败,错误信息通常是:error: class, interface, or enum expected 或更隐晦的“package not found”。
-
package语句前**不能有任何代码、空行、单行注释//或块注释/*...*/**(但允许UTF-8 BOM) - 如果用了IDE自动生成模板,留意是否默认加了
/** ... */头部注释——得手动把它挪到package之后 - 包名全部小写,用点号分隔层级,例如:
com.example.util,对应磁盘路径com/example/util/
import语句的位置和常见误用
import必须紧跟package(如果有),且位于任何class、interface定义之前。它只对当前文件生效,不传递、不继承。
- 不能在类内部写
import(比如想在某个方法里临时导入),JVM不支持这种动态导入 -
import java.util.*;会导入java.util下所有public类,但**不会递归导入子包**(如java.util.concurrent需单独写) - 同名类冲突时(如
java.util.Date和java.sql.Date),必须用全限定名,或只导入其中一个,另一个用java.sql.Date显式调用 - 静态导入(
import static)仅用于导入静态成员,如import static java.lang.Math.PI;,滥用会导致可读性下降
默认包与无package声明的风险
不写package语句,类会被放入“默认包”。这在小型练习中看似方便,但在真实项目中会引发一系列问题:
立即学习“Java免费学习笔记(深入)”;
- 无法被其他包中的类通过
import引用(JLS明确禁止导入默认包中的类型) - 模块化(Java 9+
module-info.java)完全不支持默认包 - 多数构建工具(Maven/Gradle)要求源码按包路径组织,放错目录会导致编译跳过该文件
- IDE可能无法正确识别依赖关系,自动补全失效
package com.example.math;import java.util.Objects; import static java.lang.Math.abs;
public class Calculator { public int add(int a, int b) { return a + b; } }
包路径和文件系统路径必须严格一致,这是Java加载类的基础规则。哪怕只是大小写差一个字母,或IDE里没刷新目录结构,都会导致ClassNotFoundException——这个细节在跨平台开发或CI环境中特别容易被忽略。










