Module Import Declarations：一行导入一个模块

问题：java.base 有几十个包01

一个普通程序经常同时用到 java.util、java.io、java.time、java.util.concurrent 等包。传统写法是一串 import xxx.*;；模块导入把「一个模块导出的所有包」压成一行。

import module java.base;

import java.util.List;

public class ModuleImportDemo {
    public static void main(String[] args) {
        List<String> names = List.of("scoped", "values");
        System.out.println(names);
        System.out.println(java.time.LocalDate.of(2025, 9, 16));
    }
}

javac --release 25 -d out ModuleImportDemo.java
java -cp out ModuleImportDemo

[scoped, values]
2025-09-16

• import module 可以出现在 classpath 代码里，不要求你自己写 module-info。
• 它可以和普通 import 混用；同一个模块重复导入不报错。
• 它导入的是包，不是模块依赖；不会把模块加到运行时图里。

语义：导出的包 + 传递读到的模块02

import module M; 导入两类包：M 向当前模块导出的包，以及当前模块因为读取 M 而读取到的模块所导出的包（即 M 的 transitive requires 链）。这让「模块 API 引用了别的模块类型」时不必再逐条导入。

import module java.sql;

public class SqlImport {
    DataSource ds; // javax.sql.DataSource，通过 java.sql 的传递读入
}

• 只导入向当前模块导出的包；未导出包不可用。限定导出（exports ... to）只有在导出给当前模块时才可用，导出给其他模块的不会进入范围。
• 不能导入 classpath 上的未命名模块；模块导入只接受模块名。
• 不改变反射访问：没有 open，setAccessible 仍然受限。
• 在命名模块中，当前模块必须已经读取 M；import module 不会补上 requires。

同名类：模块导入会制造歧义03

模块导入是按需导入的放大版，因此两个模块导出同名简单类时，使用简单名会编译失败。最典型的例子是 java.util.List 与 java.awt.List。

import module java.base;
import module java.desktop;

public class AmbiguousList {
    List<String> names;
}

AmbiguousList.java:5: error: reference to List is ambiguous
    List<String> names;
    ^
  both class java.awt.List in java.awt and interface java.util.List in java.util match
1 error

解决办法是加更具体的导入。单类型导入优先级最高；按需包导入次之；模块导入最弱。下面的代码用 import java.util.List; 消除了歧义。

import module java.base;
import module java.desktop;

import java.util.List;

public class ResolvedList {
    public static void main(String[] args) {
        List<String> names = List.of("a", "b");
        System.out.println(names);
    }
}

[a, b]

• 单类型导入 > 按需包导入 > 模块导入；后者会被前者遮蔽。
• java.base + java.sql 的 Date、java.desktop 内部的 Element 也会冲突。
• 不用简单名（写全限定名）不会触发歧义。
• 同一个包被多条声明导入不会报错；冲突只发生在不同包的同名类型。

边界：不是模块化，也不是万能导入04

import module java.base 不会导入 java.sql，因为 java.sql 不是 java.base 导出的包。下面的编译错误说明「模块导入」只覆盖该模块及其传递读到的模块，不是全 JDK 导入。

import module java.base;

public class NoSql {
    Connection connection;
}

NoSql.java:4: error: cannot find symbol
    Connection connection;
    ^
  symbol:   class Connection
  location: class NoSql
1 error

在命名模块中，import module 的前提是当前模块已经读取目标模块；它不会隐式添加 requires。因此它不能用来「绕过」模块依赖声明，只是让已读模块的 API 更容易导入。

落地：什么时候值得用05

• 按 JEP 511 的建议分组：模块导入在前，包按需导入居中，单类型导入在后。
• 代码审查时把模块导入当成「依赖声明」看：它扩大了可见名字集合。
• 从 24 预览迁到 25 正式时，去掉 --enable-preview；但 24 的预览 class 仍不能直接在 25 运行。
• IDE 的自动导入可能不认识模块导入；团队要统一格式，避免来回改。

版本边界BOUNDARY

这张表比 API 本身更值得记。写代码时先确认你的运行时版本。

费曼自检SELF CHECK

先合上页面，用自己的话回答，再展开对照。能讲出因果和反例，才算真正掌握。