# 库

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

一个库是您可以添加到项目中的已编译代码集合。 在 IntelliJ IDEA 中，可以在三个级别定义库：  global （适用于多个项目）、  project （适用于项目内的所有模块）和  module （适用于一个模块）。

Java 库可以包含类文件、归档文件和包含类文件的目录以及包含本地库的目录  `.dll` 、  `.so` 或  `.jnilib` 。

> **Note:**
> 此信息适用于使用原生 IntelliJ IDEA 构建器构建的项目。 如果您正在使用构建工具，例如 [Maven](maven-support.html) 或 [Gradle](gradle.html)，请使用构建文件进行所有更改。

如果想创建自己的可重用 Java 库，请创建并构建一个 Java 项目（例如，使用 Gradle 或 Maven）以生成 JAR，然后将该 JAR 添加或声明为依赖项。 如需了解详情，请参阅 [Maven 入门指南](https://maven.apache.org/guides/getting-started/index.html) (maven.apache.org) 或面向 Gradle 的 [构建 Java & JVM 项目](https://docs.gradle.org/current/userguide/building_java_projects.html) (docs.gradle.org)。

## 定义库

在您定义库并将其添加到模块依赖项之后，IDE 会在您编写代码时为您提供其内容。 IntelliJ IDEA 还将使用库中的代码来构建和部署您的应用程序。

> **Tip:**
> 您还可以从项目内容根目录中的 JAR 文件中创建一个新的库。 在   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中选择这些文件，然后从上下文菜单中选择   添加为库  。

Procedure: 定义全局库

1. 在主菜单中，前往  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。

2. 在   平台设置   下，选择   全球库  。

3. 点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 并选择以下选项之一：

* 选择 Java 或 Kotlin/JS ，以从计算机上的文件添加库。

* 选择 从 Maven 以 [从 Maven 下载库](#download-libraries-from-maven)。

![定义全局库](https://resources.jetbrains.com.cn/help/img/idea/2026.3/define-global-library.png)

在此对话框中，还可以： ![添加](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) [向现有库添加类](#add_classes_to_libraries)， ![指定文档 URL](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.toolbarDecorator.addLink.svg) [指定外部文档 URL](#add-library-docs)， ![排除](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.modules.addExcludedRoot.svg) [从库中排除项](#excluded_lib_items)，或 ![移除](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg) 移除库。

全局库的引用存储在 IDE [配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory) 中的  `options | applicationLibraries.xml` 。

Procedure: 定义项目库

1. 在主菜单中，前往  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。

2. 在   项目设置   下，选择   库  。

3. 点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 并选择以下选项之一：

* 选择 Java 或 Kotlin/JS ，以从计算机上的文件添加库。

* 选择 从 Maven 以 [从 Maven 下载库](#download-libraries-from-maven)。

![定义项目库](https://resources.jetbrains.com.cn/help/img/idea/2026.3/define-project-library.png)

4. 请选择您要添加新库的模块。

在此对话框中，还可以： ![添加](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) [向现有库添加类](#add_classes_to_libraries)， ![指定文档 URL](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.toolbarDecorator.addLink.svg) [指定外部文档 URL](#add-library-docs)， ![排除](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.modules.addExcludedRoot.svg) [从库中排除项](#excluded_lib_items)，或 ![移除](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg) 移除库。

对项目库的引用与项目一起存储在  `.idea` 文件夹中的  `libraries` 中。

Procedure: 将库添加到模块依赖项

在将全局库和项目库添加到模块依赖项之前，它们不可用。

1. 在主菜单中，前往  `文件 | 项目结构 | 项目设置 | 模块` 。

2. 请选择要为其添加库的模块，然后点击   依赖项  。

3. 点击 ![添加](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 按钮并选择   库  。

![添加新模块库](https://resources.jetbrains.com.cn/help/img/idea/2026.3/add-new-module-lib.png)

4. 在打开的对话框中，选择您要添加到模块的项目或全局库。

或者，点击   新库   并选择所需选项：可以从计算机上的文件添加 Java 和 Kotlin 库，或从 Maven 下载库。

![添加新模块库](https://resources.jetbrains.com.cn/help/img/idea/2026.3/add-new-module-lib2.png)

模块库的引用存储在模块  `.iml` 文件中。 此文件用于保存模块配置。 有关模块文件的更多信息，请参阅 [模块](creating-and-managing-modules.html)。

Procedure: 从 Maven 下载库

1. 在主菜单中，转到  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))，点击   库  添加项目库或   全球库  添加全局库。

2. 点击 ![添加](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 并选择   从 Maven  。

3. 在接下来的对话框中，指定库 artifact。 如果您不知道确切的名称，请输入关键字并点击 ![搜索](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.search.svg)。

您还可以指定另一个库位置，并选择是否要下载传递依赖项、源文件、Javadoc 文件或注释。

![从 Maven 下载库](https://resources.jetbrains.com.cn/help/img/idea/2026.3/projects_libraries.png)

IntelliJ IDEA 将从 Maven 或 Nexus 公共存储库下载库。 您还可以配置一个 [自定义远程存储库](#configure-custom-remote-repo)。

Procedure: 将类添加到库中

一旦添加库，您可以向其添加更多类：

1. 在主菜单中，前往  `文件 | 项目结构` 。 然后点击   全球库  以修改全局库或   库  以修改项目库。

要修改模块库，请从主菜单中选择  `文件 | 项目结构`  并转到  `模块 | 依赖项` 。 选择您要修改的库并点击 ![编辑](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.edit.svg)。

![向库中添加类](https://resources.jetbrains.com.cn/help/img/idea/2026.3/add_classes_to_lib.png)

2. 点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 并在打开的对话框中选择您要添加的类。

对于 Java 库而言，这些可能是单个  `class` 和  `java` 文件、目录及包含此类文件的档案  `jar` 和  `zip` ，或者包含 Java 本地库的目录  `.dll` 、  `.so` 或  `.jnilib` 。

3. IntelliJ IDEA 将分析所选的文件和文件夹，并自动将其内容分配到适当的库类别（类、源、文档、本机库位置等）。

当 IntelliJ IDEA 无法推断类别时（例如，选择空文件夹时），将显示一个对话框，可在其中自行指定类别。

Procedure: 包括特定的传递依赖项

如果您只想包含特定的传递依赖项，可以使用库属性编辑器。

1. 在主菜单中，转到  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))，然后转到  `模块 | 依赖项` 。

2. 请选择必要的 Maven 库，然后点击 ![编辑](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.edit.svg)。

3. 在下一个对话框中，点击   编辑  ，然后点击   配置  旁边的   包含传递依赖  选项。

4. 请选择您想要包含在库中的依赖项，然后点击   OK  。

## 更改库级别

Procedure: 将库移至更高的级别

在 IntelliJ IDEA 中，您可以将项目或模块库移至更高级别。 如果您想扩展其使用范围，这很有帮助。 例如，如果您想在整个项目或整个 IDE 中使用模块库，请使用此过程。

1. 在主菜单中，转到  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) 并找到要更改的库。

2. 右键点击所需的库并选择   移动到项目库   或   移动到全局库  。

![将模块库移动到更高层级](https://resources.jetbrains.com.cn/help/img/idea/2026.3/change-lib-level.png)

Procedure: 将库复制到较低级别

您可以在较低级别创建库的副本。 例如，若您想向项目库中添加更多类，但仅希望在一个模块中使用它们，请使用此过程。

1. 在主菜单中，转到  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) 并找到要更改的库。

2. 右键点击所需的库并选择   复制到项目库   或   添加到模块  。

![将全局库复制到更低级别](https://resources.jetbrains.com.cn/help/img/idea/2026.3/move-lib-lower.png)

## 排除库项

IntelliJ IDEA允许您暂时排除库项目以提高IDE性能。 您可以排除文件夹、档案（例如 JARs）和档案内的文件夹。

来自排除包的类不会显示在代码补全建议列表中，对此类的引用将在编辑器中显示为未解析，等等。 但是，当您编译或运行代码时，库仍将整体使用，而不论该库中是否有排除的项目。

Procedure: 从项目或全局库中排除项目

1. 在主菜单中，转到  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) 并点击   库  。

2. 点击 ![排除](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.modules.addExcludedRoot.svg) 并选择要排除的库项。

Procedure: 从模块库中排除项

1. 在主菜单中，前往  `文件 | 项目结构`  `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))并选择  `模块 | 依赖项` 。

2. 选择您要修改的库，然后点击 ![编辑](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.edit.svg)。

3. 点击 ![排除](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.modules.addExcludedRoot.svg) 并选择要排除的库项。

排除的项目将用 ![排除根目录](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.modules.excludeRoot.svg) 图标标记。 若要将库项目恢复到初始状态，请删除排除的项目。

## 配置自定义远程存储库

Procedure:

您可以在设置中查看远程存储库的完整列表并添加自定义存储库。 请注意，IntelliJ IDEA 可以从 Maven 加载库，即使您没有将 Maven 用作项目的构建工具。

1. 在   设置   对话框 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 中，转到  `构建、执行、部署｜远程 Jar 仓库` 。

2. 请在相应的对话框部分中点击   添加  ，并指定存储库网址。

## 配置库文档

您可以将库文档添加到 IntelliJ IDEA，以便您可以直接从编辑器中的 [快速文档](viewing-reference-information.html#inline-quick-documentation)弹出窗口获取符号和方法签名的信息。

您还可以通过指定在线参考信息的路径来配置外部文档。 外部文档会在浏览器中打开所需信息，以便导航到相关符号，同时保留该信息以供后续参考。

> **Tip:**
> 如果正在 [从 Maven 下载库](#download-libraries-from-maven)，请选择   JavaDoc   复选框，以便在获取库代码的同时获取库文档。

Procedure: 指定库文档路径

要查看外部库文档，请先配置文档 URL。

1. 打开   项目结构   对话框（ `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))），然后转到   库  。

2. 从列表中选择一个库，然后点击对话框右侧区域中的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.toolbarDecorator.addLink.svg)   指定文档 URL  。

3. 在打开的对话框中，输入 Javadoc 站点的根 URL，然后点击   OK  。

![在项目结构对话框中指定库文档路径](https://resources.jetbrains.com.cn/help/img/idea/2026.3/external-lib-docs-url.png)

4. 应用更改并关闭对话框。

Procedure: 将库文档添加到您的项目

您可以将下载的文档添加到您的项目中，以便能够离线访问。

1. 打开   项目结构   对话框（ `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))），然后转到   库  。

2. 从列表中选择一个库，然后点击对话框右侧区域中的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)   添加  。

![在项目结构对话框中通过文件添加库文档](https://resources.jetbrains.com.cn/help/img/idea/2026.3/add-library-docs.png)

3. 在打开的对话框中，选择包含文档的 JAR 文件，然后点击   打开  。

4. 应用更改并关闭对话框。

配置文档后，可以 [在编辑器中打开它](viewing-reference-information.html#inline-quick-documentation)。

## See also

### 过程

[Module dependencies](working-with-module-dependencies.html) [配置 JavaScript 库](configuring-javascript-libraries.html) [将应用程序打包成 JAR](compiling-applications.html#package_into_jar)