IntelliJ IDEA 2025.2 Help

自动导入

如果您正在使用尚未导入的类、静态方法或静态字段,IDE 会显示一个工具提示,提示您添加缺失的导入语句,这样您就不需要手动添加。 按 Alt+Enter 接受建议。

如果有多个可能的导入来源,按下 Alt+Enter 将打开建议列表。

要更改导入工具提示的背景颜色,请按 Ctrl+Alt+S 并转到 编辑器 | 配色方案 | 常规 | 弹出窗口和提示 | 问题提示

自动添加导入语句

您可以配置 IDE,使其在没有可供选择的选项时自动添加 import 语句。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|通用|自动导入

  2. 选中 动态添加明确的import 复选框,并应用更改。

    当您粘贴包含尚未导入的类或静态方法和字段引用的代码块时,IDE 会自动插入缺失的 import 语句。 如果您想更改此设置,请从 粘贴时插入import(I) 列表中,选择 询问 以确认每次插入或 从不 以手动插入 import 语句。

    添加未明确的导入内容复选框

导入包而不是单个类

IntelliJ IDEA 建议默认导入单个类。 您可以更改设置来导入整个包。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 代码风格 | Java | 导入

  2. 清除 Use single class import 复选框并应用更改。

禁用导入工具提示

当工具提示被禁用时,未解析的引用会被下划线标记,并用红色灯泡图标标记 “快速修复”按钮。 要查看建议列表,请点击此图标(或按 Alt+Enter ),然后选择 导入类

禁用所有工具提示

  • 将鼠标悬停在编辑器右上角的检查小部件上,点击 更多 ,然后禁用 显示自动导入工具提示 选项。

禁用类或静态方法和字段的工具提示

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|通用|自动导入

  2. 请确保为 显示自动导入工具提示 设置选择了必要的选项(默认情况下两个复选框, Static 方法和字段(S) ,都已启用)。

禁用通配符导入

当 IntelliJ IDEA 从同一个包中导入的类数量达到限制(默认情况下为 5 )时,IDE 会修改语句以导入整个包,而不是从该包中导入几个单独的类:

通配符导入

禁用通配符导入以始终导入单个类

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 代码样式 | Java

  2. 确保启用了 Use single class import 选项。

  3. Class count to use import with '*'Names count to use static import with '*' 字段中,指定的值应当显著超过包中的类数以及类中的名称数(例如, 999)。

要在不更改设置的情况下,用单个类导入替换文件中的导入语句,请将文本光标放置在导入语句处,按 Alt+Enter (或使用意图操作 意图操作图标 图标),然后选择 替换为单个类导入

禁用自动导入

如果您想完全禁用自动导入,请确保:

为自动导入优先选择类

此功能允许您自动导入常用的静态方法。 当您输入来自优先类的方法时,IDE 会显示补全建议。 从列表中选择一个建议会插入相应的导入语句,而无需手动编辑。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|通用|自动导入

  2. 在补全中包含 static 成员的自动导入 部分,点击 "添加"按钮 或按 Alt+Insert

  3. 在打开的对话框中,指定您想要添加到列表中的类。 您可以通过名称搜索类,或从项目结构中选择它们。

  4. 在类名的右侧,您还可以选择是否仅在当前项目中优先考虑它,还是在所有项目中(全局)优先考虑它。

  5. 应用更改并关闭对话框。

从自动导入中排除类和包

导入建议列表中可能包含您不需要的类和包。 您可以从自动导入中排除冗余条目,这样建议列表中只包含相关条目。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|通用|自动导入

  2. 从自动导入和补全中排除 部分,点击 "添加"按钮 或按 Alt+Insert ,并指定您想要排除的类或包。

    您还可以选择是否排除当前项目或所有项目(全局)。

排除类或包

  1. Alt+Enter 打开导入建议列表。

  2. 点击包旁边的右箭头,选择您要排除的项目(一个类或整个包)。

  3. 从自动导入和补全中排除 部分的 自动导入 对话框中,选择是否要从当前项目或所有项目中排除项目,然后应用更改。

优化 import

优化import 功能帮助您删除未使用的导入,并根据 设置 | 编辑器 | 代码样式 | <language> | Import 中指定的规则整理当前文件或目录中所有文件的导入语句。

优化所有导入

  1. 项目 工具窗口中选择文件或目录 (View | 工具窗口 | 项目)。

  2. 请执行以下任一操作:

    • 在主菜单中,前往 代码 | 优化import (或按 Ctrl+Alt+O)。

    • 从上下文菜单中选择 优化import

  3. (如果您选择了一个目录)请选择是否要优化目录中所有文件中的导入,还是仅优化本地修改的文件(如果您的项目在版本控制下),然后点击 运行

移除未使用的 import

  1. 将文本光标置于未使用的导入语句处,然后按 Alt+Enter ,或使用 意图操作按钮 图标。

    未使用的语句默认显示为灰色。

  2. 从建议列表中选择 移除未使用的import

    删除 use 语句

在提交时优化导入

如果您的项目在版本控制下,您可以配置 IntelliJ IDEA 在将修改文件提交到 VCS 之前优化导入。

  1. Alt+0 打开 提交 工具窗口,然后点击 显示提交选项 设置按钮

  2. 点击 显示提交选项 ,并在提交消息区域,选中 优化import 复选框。

    在提交前优化导入

自动优化导入项在保存时

您可以配置 IDE,以便在修改后的文件 保存时自动优化导入。

  1. Ctrl+Alt+S 打开设置,然后选择 工具 | 保存时的操作

  2. 启用 优化import(O) 选项。

    另外,从 所有文件类型 列表中选择您想要优化导入的文件类型。

  3. 应用更改并关闭对话框。

在重新格式化文件时优化导入

您可以告知 IntelliJ IDEA 在每次重新格式化文件时优化导入。

  • 在编辑器中打开文件,按 Ctrl+Alt+Shift+L ,并确保在打开的 重新格式化文件 对话框中选中 优化 import 复选框。

    文件重格式化对话框

之后,每次您在此项目中按 Ctrl+Alt+L 时,IntelliJ IDEA 将自动优化其导入。

实时优化导入

您还可以配置 IDE 自动优化导入。 IntelliJ IDEA 将根据 设置 | 编辑器 | 代码样式 | <language> | Import 中指定的规则删除或修改导入语句,您在编辑器中工作时。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器|通用|自动导入

  2. 启用 动态优化import 选项并应用更改。

最后修改日期: 2025年 9月 22日