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 中声明依赖
依赖通过 <dependency></dependency> 块声明，Maven 会自动下载 JAR 包及其传递依赖到本地仓库（默认 ~/.m2/repository）。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
关键字段必须齐全：<groupid></groupid>、<artifactid></artifactid>、<version></version>。缺一不可，否则构建失败。
-
<scope></scope>控制依赖生效范围：默认compile（编译+运行），测试用test（如junit），提供类但不参与编译用provided（如servlet-api） - 版本号尽量避免写死，推荐用
<properties></properties>统一管理，例如定义<junit.version>5.10.0</junit.version>后，在<version></version>中引用${junit.version} - 不要手动下载 JAR 放进
lib/目录——Maven 会忽略它，还可能引发冲突
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>3.2.4</version>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>5.10.0</version>
<scope>test</scope>
</dependency>
</dependencies>
常见错误和排查要点
依赖没生效？项目报 ClassNotFoundException 或 NoClassDefFoundError？大概率是 pom.xml 配置出了问题。
- Maven 没识别到
pom.xml：检查是否在正确目录执行命令（必须在含pom.xml的目录下运行mvn clean compile） - 依赖下载失败：看控制台是否输出
Could not transfer artifact ... from/to central，可能是网络或镜像源配置错误；检查~/.m2/settings.xml中<mirror></mirror>是否指向可用地址 - 版本冲突：多个依赖间接引入同一库的不同版本，Maven 默认采用“最近依赖优先”策略，结果可能不符合预期；用
mvn dependency:tree -Dverbose查看完整依赖树，再用<exclusions></exclusions>排除不需要的传递依赖 - 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 服务器、同事电脑）如果依赖来源不统一，极易出现“在我机器上能跑”的现象。只有严格通过 pom.xml 管理，才能保证构建可重现。
