# 添加框架（面）

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

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

对于开发特定框架的应用程序，IntelliJ IDEA 具有 facets。 构件包含库、依赖关系和技术，并为您提供用于配置特定框架设置的其他 UI 元素。

请注意，并非所有方面都能即用。 若要使用其中的一些功能，您需要先为所需的框架安装一个插件。 有关现有插件的更多信息，请参阅 [JetBrains Marketplace](https://plugins.jetbrains.com/) 。

IntelliJ IDEA 可以识别某个框架特有的文件或目录，并为您添加所需的 Facet。 一旦检测到该 facet 并添加后，IntelliJ IDEA 将会通知您缺少的配置并建议必要的操作。

如果未能自动检测到一个 facet，您可以 [手动添加](#manually-add-facet-to-module)。 您可以向模块添加多个 facet。

> **Note:**
> 某些框架仅在 Ultimate 订阅中提供。 请参阅 [比较矩阵](https://www.jetbrains.com/zh-cn/idea/features/editions_comparison_matrix.html)，以确保您的 IntelliJ IDEA 支持所需的框架。

您可以在   项目结构   对话框中找到项目中为模块配置的所有 facets：在主菜单中，转到  `文件 | 项目结构`  ( `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))) 并选择   模块  。

如果您在项目中使用构建工具，比如 [Maven](maven-support.html) 或 [Gradle](gradle.html)，请使用构建文件进行所有更改。

![在项目结构对话框中为模块配置的 Facets](https://resources.jetbrains.com/help/img/idea/2026.3/facets-in-modules.png)

Procedure: 手动将 Facet 添加到模块

1. 按 `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))，或转到主菜单中的  `视图 | 工具窗口 | 项目`  以打开   项目   工具窗口。

2. 在   项目   工具窗口中，选择要为其添加 Facet 的模块。

3. 按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) 并输入  `Add Framework Support` 。

一旦找到操作，点击它以打开   Add Framework Support  对话框。

4. 从列表中选择必要的框架。

根据您的选择，您可能会被提示配置其他设置（例如，配置库）。

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

![手动添加新的 facet](https://resources.jetbrains.com/help/img/idea/2026.3/framework_support_dialog.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))) 并选择   Facet  。

2. 选择   检测中   并点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))。

3. 从   要排除的框架   列表中选择所需选项。

您可以仅在一个目录或整个项目中禁用特定框架的自动检测。 该列表还允许您禁用特定目录中所有框架的自动检测。

4. 如果您希望在整个项目中禁用所有框架的自动检测，请取消选择   启用框架检测   复选框。

要重新启用所有地方的自动检测，请选中   启用框架检测  复选框，并从   从检测中排除  列表中删除所有条目。

![从自动检测中排除框架](https://resources.jetbrains.com/help/img/idea/2026.3/framework-detection.png)

> **Tip:**
> 在此对话框中，您还可以删除框架或添加新框架。