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之后、类定义之前。它只是告诉编译器“这个类名在哪个包里”,不加载类、不触发初始化、也不影响运行时性能。
立即学习“Java免费学习笔记(深入)”;
使用import java.util.*;看似方便,但可能引发命名冲突(比如同时用到java.sql.Date和java.util.Date),且降低可读性——别人无法一眼看出你到底用了哪些类。
Psky企业网站是基于PHP+MYSQL开发的一款企业官网宣传网站,支持PC、wap浏览。 主要功能包括导航管理、轮播新闻、单位动态、通知通报、单位简介、后台管理等。运行环境下载安装PHPStudy(小皮)即可。系统采用PHP语言(版本:7.3.4nts)和MYSQL(版本:5.7.26)数据库进行开发,安装PHPStudy(小皮)集成环境进行测试通过。安装步骤:1、导入SQL文件到PHPmyad
- 推荐显式导入:例如
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服务器上必挂。
- IDE(如IntelliJ)创建包时会自动建对应目录;手动建目录后,务必确认包声明与路径完全匹配
- 命令行编译需用
javac -d out src/com/example/Main.java,其中-d指定输出目录,src/是源码根目录 - 打包成JAR后,包结构变成JAR内路径,此时类加载器仍按相同规则查找——所以JAR里的目录层级不能乱
包结构不是命名习惯,是Java类加载机制的硬性契约。写错一行package,或挪错一个文件夹,就可能让整个模块在运行时突然找不到类。









