在 IntelliJ IDEA 中,.iml
文件是 模块配置文件(IDEA Module File),它主要用来告诉 IDEA:
-
这个模块的 源代码目录、资源目录、测试目录 在哪里
-
依赖的 JDK 版本
-
引用的 第三方依赖(Jar、Maven、Gradle 等)
-
编译输出目录(class 文件生成位置)
-
模块类型(Java、Web、Kotlin、Android 等)
作用
-
记录模块结构
IDEA 把项目拆分成一个或多个模块(Module),每个模块有自己的.iml
,IDEA 根据这个文件知道该模块的代码在哪、怎么编译。 -
存储依赖关系
如果是纯 Java 项目(非 Maven/Gradle),.iml
会列出你添加的 Jar 包路径,这样 IDEA 在编译和运行时才知道去哪里找这些类。 -
IDEA 专用,不是 Java 标准文件
.iml
不是 Java 语言的一部分,也不是必须提交到代码仓库的内容(除非你要让别人直接用 IDEA 打开并保持相同配置)。
常见情况
-
Maven 项目
.iml
文件内容会很简洁,大部分依赖信息在pom.xml
里,IDEA 会自动生成和更新.iml
。 -
非 Maven 项目
.iml
记录所有源码目录和 Jar 包路径,一旦.iml
损坏或丢失,IDEA 可能会找不到类或无法运行项目。
💡 总结
.iml
就像是 IDEA 给每个模块的“身份证”,让它知道代码在哪、依赖什么、怎么编译运行。
如果 .iml
丢了,可以:
-
对于 Maven/Gradle 项目:
File → Invalidate Caches / Restart
或重新导入pom.xml
/build.gradle
自动生成 -
对于普通 Java 项目:需要手动重新标记
Sources Root
和添加依赖