pom.xml 是 Maven 项目的强制性核心配置文件，定义项目坐标、依赖、构建行为等；依赖通过声明，需包含 groupId、artifactId、version，scope 控制作用域，版本宜用 properties 统一管理。

pom.xml 是 Maven 项目的配置核心文件，它定义了项目坐标、依赖、构建行为和插件配置。没有它，Maven 就不知道怎么编译、打包或拉取第三方库。

什么是 pom.xml 文件

它是 Project Object Model（项目对象模型）的 XML 描述文件，相当于 Maven 项目的“身份证+说明书”。Maven 所有操作（mvn compile、mvn package 等）都基于这个文件解析项目结构和规则。

每个 Maven 项目根目录下必须有且仅有一个 pom.xml；它不是可选配置，而是强制入口。

如何在 pom.xml 中声明依赖

依赖通过 块声明，Maven 会自动下载 JAR 包及其传递依赖到本地仓库（默认 ~/.m2/repository）。

关键字段必须齐全：、、。缺一不可，否则构建失败。

• 控制依赖生效范围：默认 compile（编译+运行），测试用 test（如 junit），提供类但不参与编译用 provided（如 servlet-api）
• 版本号尽量避免写死，推荐用 统一管理，例如定义 5.10.0 后，在 中引用 ${junit.version}
• 不要手动下载 JAR 放进 lib/ 目录——Maven 会忽略它，还可能引发冲突

  
    org.springframework.boot
    spring-boot-starter-web
    3.2.4
  
  
    org.junit.jupiter
    junit-jupiter
    5.10.0
    test
  

常见错误和排查要点

依赖没生效？项目报 ClassNotFoundException 或 NoClassDefFoundError？大概率是 pom.xml 配置出了问题。

• Maven 没识别到 pom.xml：检查是否在正确目录执行命令（必须在含 pom.xml 的目录下运行 mvn clean compile）
• 依赖下载失败：看控制台是否输出 Could not transfer artifact ... from/to central，可能是网络或镜像源配置错误；检查 ~/.m2/settings.xml 中 是否指向可用地址
• 版本冲突：多个依赖间接引入同一库的不同版本，Maven 默认采用“最近依赖优先”策略，结果可能不符合预期；用 mvn dependency:tree -Dverbose 查看完整依赖树，再用 排除不需要的传递依赖
• IDE 没同步变更：修改 pom.xml 后，IntelliJ 要点右键 → Maven → Reload project；Eclipse 需右键 → Update Project…

为什么不能跳过 pom.xml 直接写代码

因为 Maven 不靠目录结构或文件名推断依赖，它只认 pom.xml 的声明。哪怕你把 commons-lang3-3.12.0.jar 手动放进 src/lib，只要没在 pom.xml 里声明，Maven 编译时就看不到它，IDE 也会标红。

更隐蔽的问题是：不同环境（开发机、CI 服务器、同事电脑）如果依赖来源不统一，极易出现“在我机器上能跑”的现象。只有严格通