IDEA自动导包需同时开启Add unambiguous imports on the fly和Optimize imports on the fly；同名类需启用Show import popup；类不提示则检查classpath是否刷新；排除列表中泛匹配项会导致导包失效。
自动导包不生效？先确认这两个开关是否真打开了
IDEA 的自动导包不是“开了设置就一定动”，它依赖两个关键开关同时启用，缺一不可。很多人勾选了却没效果，就是因为只开了一个。
-
Add unambiguous imports on the fly：这是“自动导入”的核心——只有它打开，输入ArrayList后按Enter才会补上import java.util.ArrayList; -
Optimize imports on the fly：这个控制“实时删无用 import”。它不负责导入，但一旦关了，你删掉new Date()后，import java.util.Date;会一直留着，越积越多
注意：Optimize imports on file save 是个备选方案（保存时才清理），但不如 on the fly 真实及时，建议优先用后者。
同名类冲突时为什么没弹窗？检查 Show import popup
遇到 Date、Optional、Path 这类多包共存的类，IDEA 默认不自动猜——它怕导错。所以你输完按 Enter，光标可能直接跳走，什么也没发生。
- 真正触发选择弹窗的开关是：
Show import popup（在Auto Import设置页底部） - 勾上它，下次输入
Date→ 触发补全 → 列表里出现Date (java.util)和Date (java.sql)→ 方向键选中 →Enter，立刻导入对应包 - 如果不勾，IDEA 就保持沉默，等你手动
Alt+Enter呼出意图菜单
这个选项常被忽略，但它才是解决“明明有类却导不进”问题的第一现场。
明明类存在，却完全不提示导入？可能是 classpath 没刷进来
自动导包不是靠“猜”，而是靠 IDEA 已索引的类路径。Maven/Gradle 项目最容易卡在这一步：pom.xml 或 build.gradle 改了依赖，但 IDEA 还不知道。
- Maven 项目：右键
pom.xml→Add as Maven Project，或点右上角Reload project提示 - Gradle 项目：确保
build.gradle已加载（看右上角有没有 “Load project” 黄条，点了再等索引完成） - 普通模块：进
File → Project Structure → Modules → Dependencies，确认 SDK 和库没标红、路径没断
如果 ArrayList 都不提示，别急着调设置，先 File → Reload project 或 Sync with File System——90% 的“失效”其实只是缓存没更新。
误加排除包导致自定义类导不进？去 Exclude from auto-import and completion 里清空
这个隐藏列表很危险：有人曾把 java.util.* 加进去想“屏蔽常用类”，结果 ArrayList、HashMap 全部失联。
- 位置在
Auto Import设置页最下方，叫Exclude from auto-import and completion - 点开后检查列表里有没有泛匹配项（如
java.*、com.*），尤其是带星号的 - 删掉所有不确定用途的条目；如果真要排除某包，尽量写全限定名，比如
com.example.internal.*，而不是com.*
这个坑不显眼，但影响面极广——它会让 IDEA 直接忽略整个包下的所有类，连补全候选都不给。
