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定义之前。它只对当前文件生效，不传递、不继承。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 不能在类内部写
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;
<p>import java.util.Objects;
import static java.lang.Math.abs;</p><p>public class Calculator {
public int add(int a, int b) {
return a + b;
}
}</p>包路径和文件系统路径必须严格一致，这是Java加载类的基础规则。哪怕只是大小写差一个字母，或IDE里没刷新目录结构，都会导致ClassNotFoundException——这个细节在跨平台开发或CI环境中特别容易被忽略。
