# Hibernate

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **TL;DR**
> 必需插件： [Jakarta EE: Persistence (JPA)](https://plugins.jetbrains.com/plugin/20202) 和 [Hibernate](https://plugins.jetbrains.com/plugin/20214)（均已捆绑）

[Hibernate](http://hibernate.org/) 是一个实现 [Jakarta Persistence (JPA)](jakarta-persistence-jpa.html) 规范的对象-关系映射框架。

IntelliJ IDEA 提供以下内容：

* 针对 Hibernate 的编码支持。

* 管理 Hibernate 配置的专用方面 `hibernate.cfg.xml` 。

* 增强了 [Persistence](persistence-tool-window.html) 工具窗口的功能，可以管理 Hibernate 项目、创建配置文件和持久类、在编辑器中导航到相关源码、打开图表和控制台等。

* 可从 [持久性](persistence-tool-window.html) 工具窗口访问的实体关系 (ER) 图。

* 通过导入数据库架构或 EJB 部署描述符文件来生成托管实体类及其对象关系映射的功能 `ejb-jar.xml` 。

* 用于编写和运行 HQL 查询并分析查询结果的 [Hibernate console](working-with-the-hibernate-console.html)。

Procedure: 创建一个新的 Jakarta EE 项目并集成 Hibernate。

1. 打开   新建项目  向导：

* 如果位于主屏幕，请选择 `![加号](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.general.add.svg) 新建 | ![文件夹图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.nodes.folder.svg) 项目……` 。

* 如果已打开另一个项目，请转到 `文件 | 新建 | 项目` 。

2. 从左侧的   生成器   列表中，选择 ![Jakarta EE 徽标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.java.ultimate.icons.icons.javaee.newui.jakartaEE.svg)   Jakarta EE  。

![Jakarta EE 项目向导的第一步](https://resources.jetbrains.com.cn/help/img/idea/2026.3/jakarta_new_project_step_1_web.png)

3. 设置 [Jakarta EE 项目设置](new-project-wizard.html#java-ee)。

准备就绪后，点击   下一步  。

4. 从   版本   下拉菜单中选择要使用的 Jakarta EE 版本。

5. 从   依赖项  列表中，选择   持久化（JPA）  规范和   Hibernate  作为实现。

![使用 JPA 和 Hibernate 的新 Jakarta EE 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/java_enterprise_new_project_step_2_hibernate.png)

6. 点击   创建  。

有关创建 Jakarta EE 项目的更多信息，例如如何设置应用程序服务器，请参阅 [教程：您的第一个 Jakarta EE 应用程序](creating-and-running-your-first-jakarta-ee-application.html)。

IntelliJ IDEA 创建了默认的项目结构，包含   JPA   [facet](adding-support-for-frameworks-and-technologies.html)和所有必要的库作为外部依赖项，例如用于 JPA 规范的  `javax.persistence` 和用于 Hibernate 框架的  `org.hibernate` 。 如果指定了 [应用程序服务器](application-servers-support.html)，IntelliJ IDEA 还将创建一个运行配置来启动服务器、构建并部署工件。

Procedure: 将 Hibernate 添加到现有项目

1. 在编辑器中打开构建文件（  `pom.xml`  或  `build.gradle` ，具体取决于项目中使用的 [构建工具](build-tools.html)）。

2. 添加 Hibernate 库，并确保其版本与项目的其余部分匹配：

Maven:

```XML
<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>7.4.5.Final</version>
</dependency>

```

Gradle (Groovy):

```GROOVY
implementation 'org.hibernate.orm:hibernate-core:7.4.5.Final'

```

Gradle (Kotlin):

```KOTLIN
implementation("org.hibernate.orm:hibernate-core:7.4.5.Final")

```

> **Note:**
> Hibernate 可能需要额外依赖项。 请参考 [官方文档](https://docs.hibernate.org/orm/7.4/repositories/html_single/#configuration-integration) 获取指导。

3. 按 `Ctrl+Shift+O` (Windows), `Ctrl+Shift+O` (macOS), `Ctrl+Shift+O` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift+O` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `Ctrl+Shift+O` (Sublime Text (macOS)), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS)) 导入更改。

有关使用构建工具的更多信息，请参阅 [Maven](maven-support.html) 或 [Gradle](gradle.html)。