Java中package声明必须位于源文件首行，前面仅允许注释或空行，且一个文件只能有一个；包名须全小写、用点分隔、遵循反向域名规则，且必须与文件系统路径严格对应。
Java中包（package）的声明非常直接，但必须严格遵守位置和语法规范，否则编译会失败。
package必须写在文件第一行
package语句是Java源文件中**唯一允许出现在最顶部的非注释语句**。它前面不能有任何代码、空行以外的空白符也不建议多加——只可有注释或纯空行。
- ✅ 正确写法：package com.example.service;
- ❌ 错误写法：public class UserService { ... } package com.example.service;（类定义在package之前）
- ❌ 错误写法：import java.util.List; package com.example.service;（import不能在package之前）
一个文件只能有一个package声明
Java不支持在一个.java文件里多次声明package，也不支持条件式或动态包名。每个源文件归属且仅归属一个包。
- 如果没写package语句，该类自动归入**默认包（unnamed package）** ——但实际项目中应避免，默认包里的类无法被其他包import引用
- 包名与文件系统路径必须严格对应：声明package com.example.dao;，则该文件必须存放在
com/example/dao/目录下
包名的构成规则
包名本质是标识符，需满足Java标识符基本要求，同时遵循行业通用约定：
立即学习“Java免费学习笔记（深入）”；
- 全部小写字母，用英文点号（.）分隔层级，如org.springframework.boot.autoconfigure
- 推荐采用**反向域名**形式，例如公司域名为
mycompany.cn，项目为user-center，则包名宜为cn.mycompany.usercenter - 禁止使用Java关键字（如
int、class）、保留字或数字开头 - 不建议用下划线（_）、连字符（-）或大写字母——虽然编译器可能不报错，但违反JDK和主流框架惯例
常见误区提醒
初学者容易忽略几个关键细节：
- IDE自动生成≠可随意修改：IntelliJ或Eclipse会帮你补全package，但若手动改了包名，务必同步调整文件所在目录，否则编译报错“class file not found”
- 无package不等于“无包”：它是默认包，但默认包中的类无法被任何带package的类import，也无法被模块化系统识别
-
包名不是路径别名：package声明的是逻辑命名空间，不是相对路径；
package a.b;不代表“从当前目录进a再进b”，而是强制要求物理路径为a/b/
