# Kubernetes

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

[Kubernetes](https://kubernetes.io/) 是一个用于部署、扩展和管理容器化应用程序的容器编排引擎。 为 IntelliJ IDEA 安装并启用  Kubernetes  插件，以添加以下功能来管理 Kubernetes 集群：

* [Kubernetes 资源配置文件](https://kubernetes.io/docs/concepts/configuration/overview/) 的编码辅助。

* 针对 [Helm](https://helm.sh/) 图表和模板的代码辅助。 有关更多详细信息，请参阅 [专用的 Helm 页面](helm.html)。

* 使用自定义资源定义（CRD）规范验证自定义资源。

* 对 [Kustomize](https://kustomize.io/) 文件的编码支持：字段和本地文件路径补全、快速文档以及在 Kustomize 文件和补丁之间导航。 打开的Kustomize补丁顶部的编辑器中会显示相关Kustomize文件的列表。

* 从 IntelliJ IDEA 与集群交互：使用 [服务](services-tool-window.html#kubernetes) 工具窗口查看 Kubernetes 集群的所有资源、跳转到相关资源定义、打开 Pod 上运行的容器日志视图等。

该  Kubernetes  插件支持 Kubernetes 版本 1.26 到 1.34（您可以 [选择适用的版本](#api-version-setting)）。

> **Note:**
> 需要 kubectl 工具与 Kubernetes 集群进行通信。 如果在 IntelliJ IDEA 中使用 Kubernetes 功能（例如，将 [添加集群](#add-cluster) 到   服务   工具窗口），但计算机上未安装 kubectl，则会显示通知，提供下载并安装其最新稳定版本的选项。
>
>
>
> kubectl 可执行文件将被安装在  `/usr/local/bin` （在 macOS 和 Linux 上）或  `<home>\.jetbrains` （在 Windows 上）。

Procedure: 启用 Kubernetes 插件

此功能依赖于 [Kubernetes](https://plugins.jetbrains.com/plugin/10485-kubernetes) 插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> 在未订阅 Ultimate 版的情况下，IntelliJ IDEA 中无法使用 Kubernetes 插件。

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)) 打开设置，然后选择  `插件` 。

2. 找到  Kubernetes  插件，然后点击   启用  。

Procedure: 指定 kubectl 的自定义路径

IntelliJ IDEA 使用由  `路径`  环境变量确定的默认 kubectl（以及 [如果您使用 helm](helm.html)）可执行文件。

如果您将 kubectl 安装在自定义目录中，您可以手动指定其路径。

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))）中，选择  `构建、执行、部署 | Kubernetes` 。

2. 在   kubectl 可执行文件的路径  字段中，指定 kubectl 可执行文件的路径。

3. 请点击   测试   查看文件位置。 如果未找到，您可以手动检查文件位置，或点击   安装  ，IntelliJ IDEA 将下载并安装缺失的软件。

Procedure: 使用自定义 Kubernetes 配置文件

有关群集的信息存储在 kubeconfig 文件中。 IntelliJ IDEA 会检测默认的 kubeconfig 文件，这个文件通常位于  `$HOME/.kube/config` （此位置可以通过  `KUBECONFIG`  环境变量更改）。 如果您希望 IntelliJ IDEA 从自定义 kubeconfig 文件而不仅仅是从默认文件获取有关集群的信息，您可以在 IDE 设置中指定它们。 您可以全局应用它，也可以为每个项目使用不同的文件。

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))）中，选择  `构建、执行、部署 | Kubernetes` 。

2. 在   其他 Kubeconfig 路径  下，点击 ![添加 kubeconfig](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)并指定到  `kubeconfig` 文件的路径。

3. 如果您想在所有项目中使用配置文件，请在   全局  列中选择   范围  。 要仅在当前项目中使用，请保留   项目  范围。

当您添加文件时，IntelliJ IDEA 会验证其语法并报告错误（如果有）。

![Kubeconfig 配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_kubeconfig_validate.png)

> **Tip:**
> 除了在 IDE 设置中指定的 kubeconfig 文件，您还可以从其他自定义 kubeconfig 文件和剪贴板 [添加集群](#add-cluster)。

Procedure: 配置 Kubernetes API 版本

IntelliJ IDEA 提供配置键值的 [代码补全](auto-completing-code.html)功能、通过边栏图标导航到相关的选择器和定义、检查过时的值和必需键的专门检查，以及其他辅助功能。 这些取决于您正在使用的 API 版本。  Kubernetes  插件支持 Kubernetes 版本 1.26 到 1.34。 默认情况下，IntelliJ IDEA 会将其设置为最新版本。 但是，如果您的资源使用的是较早的版本，您可以更改它。

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))）中，选择  `构建、执行、部署 | Kubernetes` 。

2. 根据需要更新   Kubernetes API 版本  选项。

## 资源配置文件

Kubernetes  插件为 YAML 中的资源配置文件提供了丰富的支持，而对 JSON 格式仅提供基本支持。

### 支持的功能

|  功能  |  YAML  |  JSON  |
| --- | --- | --- |
|  [自动补全](auto-completing-code.html)  |  支持  |  支持  |
|  [快速文档](viewing-reference-information.html#inline-quick-documentation)  |  支持  |  支持  |
|  [检查和快速修复](code-inspection.html)  |      * 无效、缺失和重复键    * 不可编辑（只读）键和值    * 不推荐使用的键值和资源    * 无效的整数和枚举键值    |      * 无效、缺失和重复的属性    |
|  [实时模板](using-live-templates.html)  |     预定义的通用资源类型模板     |  没有预定义的 实时模板  |
|  [智能完成](advanced-code-completion.html#invoke_smart_completion)  |  支持  |  不支持  |
|  [自定义资源定义](#crd)  |  支持  |  不支持  |
|  标签定义及选择器  |  使用装订区域图标导航、查找用法和重命名  |  不支持  |
|  原始 Kubernetes 模型的改进  |  在适用的地方使用枚举而不是普通字符串  |  无  |

IntelliJ IDEA 通过以下必填字段识别 Kubernetes 资源配置文件：

* `apiVersion` ：标识对象表示的版本化模式

* `kind` ：标识资源类型（例如， `服务` 、 `Pod` 、 `部署` 等）

如果 YAML 或 JSON 文件中存在这两个字段，IntelliJ IDEA 将使用相应的 Kubernetes 图标标记该文件，并启用所有可用功能。

Procedure: 创建资源文件

使用 IntelliJ IDEA，您可以快速创建 Kubernetes 中一些最最受欢迎的资源的配置文件。

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))）中，右键点击文件夹，选择   新建   或按 `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), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))，然后选择   Kubernetes 资源  。

2. 在   名称  字段中，输入您的资源名称并从列表中选择文件模板。

![新的 Kubernetes 资源窗口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_new_resource.png)

这将创建一个新文件，其内容基于所选 [文件模板](using-file-and-code-templates.html)。请参阅 [文件模板](using-file-and-code-templates.html)了解详情。

或者，在 YAML 文件中，您可以使用预定义的 [实时模板](using-live-templates.html)，例如：

* `kconfigmap` ：Kubernetes ConfigMap

* `kcronjob` ：Kubernetes 定时任务

* `kdeployment` ：Kubernetes 部署

* `kingress` ：Kubernetes Ingress

* `kpod` ：Kubernetes Pod

* `kresource` ：从零开始的 Kubernetes 资源

* `kservice` ：Kubernetes 服务

![Kubernetes 代码模板](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_live_templates.png)

> **Tip:**
> 要查看 Kubernetes 资源所有 实时模板 的列表、编辑它们或创建新的，请打开   设置  对话框 `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))，选择  `编辑器 | 实时代码模板` ，并展开列表中的   Kubernetes  组。

在编辑器中打开 Kubernetes 资源文件时，IntelliJ IDEA 会显示 [嵌入提示](inlay-hints.html) 和包含最常用操作的工具栏，包括：

1.

可在其中执行以下操作的浮动工具栏：

* 选择当前集群和命名空间

* ![应用图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.actions.deploy.svg) 应用更改并将其提交到当前集群

* ![删除图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.actions.undeploy.svg) 删除资源

* ![比较图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.vcs.diff.svg) 将更改与集群版本进行比较

* ![重新加载图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.refresh.svg) 从集群重新加载内容

![浮动工具栏](https://resources.jetbrains.com.cn/help/img/idea/2026.3/k8s-floating-toolbar.png)

2.  用于检查 [已部署资源状态](#view-resource-info) 的内联提示

3.  用于 [显示并复制引用的 Secret 值](#inlay-hints-secrets) 的内联提示

4.  用于 [转发端口](#forward-ports) 的内联提示

![Kubernetes 清单中的内联提示](https://resources.jetbrains.com.cn/help/img/idea/2026.3/k8s-yaml-editor-hints.png)

> **Tip:**
> 可以更改嵌入提示的外观，使其仅显示图标。 在内联提示上右键点击，然后从上下文菜单中选择   仅图标   选项。 取消选择该选项可恢复带标题的默认外观。

Procedure: 配置浮动工具栏的显示方式

您可以配置在编辑器中显示浮动工具栏的时机。

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)) 打开设置，然后选择  `构建、执行、部署 | Kubernetes` 。

2. 使用   在编辑器中显示浮动工具栏   选项选择浮动工具栏的出现时机：

* 始终

* 当鼠标移动时

* 不要显示

或者，您可以右键点击浮动工具栏并选择所需选项。

Procedure: 禁用 Kubernetes 模式验证

IntelliJ IDEA 根据 Kubernetes API 模式验证您的 Kubernetes 文件。 这包括检查其所需的关键字或可能的资源类型。

如果您的文件包含  `apiVersion`  和  `kind` ，但它不是一个 Kubernetes 文件，您可以禁用此类验证。 您可以在  `设置 | 编辑器 | 检查 | Kubernetes`  中抑制检查并更改其范围和严重性。 或者，您可以使用特殊指令标记文件以禁用其中的验证：

* 在文件开头添加  `# nonk8s` 。

* 另外，如果您已有关于未知资源的警告，右键点击   问题   工具窗口中的警告并选择  `显示快速修复 | 将此文件标记为非 Kubernetes` 。

## 管理您的集群

使用 [服务](services-tool-window.html) 工具窗口打开集群视图、在命名空间之间切换，并修改集群资源。

Procedure: 添加集群

要与 Kubernetes 集群交互，请在   服务   工具窗口中添加集群。

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 右键点击   服务   工具窗口中的 Kubernetes 节点，然后选择   添加集群  。 或者，点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.add.svg) 并选择  `Kubernetes | 添加集群` 。

接下来，选择要添加的 Kubernetes 集群的来源：

* 来自默认目录 ：从默认位置获取集群（通常为 `$HOME/.kube/config` ）。

* 来自自定义 kubeconfig ：从您的计算机中选择任意 kubeconfig 文件。

* 粘贴 kubeconfig 内容 ： 将 kubeconfig 内容粘贴到打开的文本区域中。

![选择 Kubernetes context 源](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_select_context_source.png)

3. 在打开的   添加集群   窗口中，选择要添加的集群并点击   添加集群  。

![添加集群窗口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_add_context_from_clipboard.png)

添加的 Kubernetes 集群将在   服务   工具窗口中可用。 可以通过右键点击集群并选择   在新选项卡中打开  ，在单独的选项卡中打开每个集群。

要实时监控集群资源，可以 [连接到集群](#connect-to-the-cluster)。

Procedure: 连接到集群

连接到集群以在 IDE 中与其交互：跟踪日志、预览资源、打开其配置文件视图，并在修改时获取实时更新。 即使未连接到集群，也可以在编辑器中 [修改其资源](#cluster_resources)。

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 如果   服务   工具窗口中没有集群，请 [添加集群](#add-cluster)。

3. 右键点击集群并选择   连接集群  。

![连接集群](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_connect_cluster.png)

Procedure: 编辑 kubeconfig

kubeconfig 文件包含有关集群、用户、命名空间和认证的信息。

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 选择一个集群，然后点击工具栏上的 ![在编辑器中打开 kubeconfig 文件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-kubernetes.icons.kubernetes_Y.svg) (   在编辑器中打开 Kubeconfig 文件  )。 当您右键点击   服务   工具窗口中的任意 Kubernetes 对象时，此操作也可用。

这将在编辑器的新选项卡中打开 kubeconfig 文件。 要更改此操作打开的默认文件，您可以在 [Path to kubeconfig file](#multiple-kubeconfig)中指定另一个文件的路径。

当您更改 kubeconfig 文件时，配置会自动重新加载。 您还可以手动重新加载，或者通过右键点击集群或任何 Kubernetes 对象来禁用自动重新加载，然后选择  `更多 | 自动重新加载配置` 。

![重新加载配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_reload_configuration.png)

> **Tip:**
> 默认情况下，kubeconfig 文件的最大大小限制为 10 MB。 可以在  `设置 | 高级设置 | Kubernetes | 要加载的 kubeconfig 文件的最大大小（以兆字节为单位）`  中更改此限制。

Procedure: 在命名空间之间切换

Kubernetes 命名空间允许您在集群内逻辑隔离资源。 借助 IntelliJ IDEA，您可以快速切换命名空间。

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 右键点击您的集群或任何资源，选择   命名空间  （或点击工具栏上的 !["Namespace" 图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-kubernetes.icons.newui.namespace.svg)），然后选择所需的命名空间。

要查看所有命名空间的资源，请选择   所有命名空间  。

![命名空间上下文菜单](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_switch_namespaces.png)

> **Tip:**
> 如果您希望某些命名空间显示在列表顶部，您可以通过点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.nodes.notFavoriteOnHover.svg) 将它们标记为收藏。

> **Note:**
> 如果由于基于角色的访问控制无法访问命名空间资源，您可以在  `构建、执行、部署 | Kubernetes | 集群交互 | 其他命名空间`  中设置自定义命名空间。 如果无法从集群加载命名空间，还可以通过   自定义命名空间   操作快速打开此设置。

Procedure: 选择当前集群

当前集群是指在编辑器和   项目  工具窗口中与资源交互时设置为默认的集群。

当您在本地修改或创建 [资源文件](#create_resource_file) 时，您可以通过点击 ![选择上下文](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-kubernetes.icons.newui.configuration.svg) 或使用 [浮动工具栏](#floating-toolbar) 选择要应用该资源的集群。 您也可以提前选择它。

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 右键点击集群并选择   将集群设置为当前  。

![设置当前集群](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_set_current_cluster_in_services.png)

或者，选择一个集群并点击工具栏上的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.locate.svg)。

Procedure: 在集群中创建资源

在 [创建资源文件](#create_resource_file) 之后，您可以在集群中创建相应的资源。

1. 在编辑器中打开所需的资源文件。 如果未设置当前集群，请使用 [浮动工具栏](#floating-toolbar) 进行选择。

![设置当前集群](https://resources.jetbrains.com.cn/help/img/idea/2026.3/set_current_cluster_toolbar.png)

如有必要，您还可以从列表中选择命名空间。

2. 点击 ![应用图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.actions.deploy.svg) 将更改应用到当前集群和命名空间。

Procedure: 修改集群资源

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 右键点击资源并选择   YAML 视图  。

这将在编辑器的新选项卡中打开所选资源的清单。 更改字段时，修改过的行会在装订区域中高亮显示。 您可以点击页边空白处的高亮区域快速预览或回滚更改。

3. 请确保在 [浮动工具栏](#floating-toolbar) 上选择了当前集群，然后点击 ![应用图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.actions.deploy.svg) 以应用更改。

> **Note:**
> 更改某些 Kubernetes 对象字段可能会导致创建新对象。 例如，如果您更改资源名称，应用此更改将创建一个新资源。 或者，如果您更改了命名空间，应用此更改将在指定的命名空间中创建一个新的资源。

Procedure: 资源详情视图

IntelliJ IDEA 可快速显示 Kubernetes 资源的详情视图，而无需手动运行任何命令。

* 在   服务   工具窗口中，选择一个资源以显示其详情视图。

* IntelliJ IDEA 会在编辑器中直接显示已部署的 Kubernetes 资源的实时状态。 例如，当您打开 Deployment 清单时，状态指示器会显示在  `replicas`  字段旁，显示当前正在运行、挂起或失败的 Pod 数量。

![Kubernetes 部署文件中的 Pod 状态](https://resources.jetbrains.com.cn/help/img/idea/2026.3/replicas-inlay-hints.png)

您可以在相应清单中的   名称   字段旁检查各个 Pod 和 Job 的状态。

如果发生错误且资源失败，IntelliJ IDEA 会显示   打开日志   链接，帮助您快速导航到描述该问题的相关日志条目。

![打开日志链接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/k8s-error-open-logs.png)

Procedure: 删除资源

您可以通过以下任何一种方式删除资源：

* 在   服务  工具窗口中，右键点击资源并选择   删除  。

* 在   服务  工具窗口中，选择一个资源并在工具栏上点击 ![删除资源](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.delete.svg)（   删除资源  ）。

* 如果在编辑器中打开了该资源 YAML 文件，请在浮动工具栏上选择当前集群并点击 ![删除资源](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.actions.undeploy.svg)。

* 如果已打开该资源 YAML 文件，请在编辑器的任意位置点击鼠标右键；如果浮动工具栏上未选择集群，请选择   删除(当前集群未配置)  ，否则请选择   从 集群 "cluster_name" 和 命名空间 "namespace_name" 中删除  。

### 转发端口

借助 Kubernetes 中的端口转发，可以将计算机上本地端口的流量重定向到 Kubernetes Pod 上的端口。 IntelliJ IDEA 可管理端口转发：可以将一个或多个本地端口转发到远程端口、显示集群中所有活动转发会话的视图（在 IntelliJ IDEA 中建立）、停止并重启转发会话。

Procedure:

1. 您可以通过以下任一方式配置端口转发：

* 打开 [服務](services-tool-window.html)工具窗口：选择 `查看 | 工具窗口 | 服务` 或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。 右键点击目标 Pod 并选择 转发端口 。

* 点击 Kubernetes 清单中的 转发端口 内联提示。 IntelliJ IDEA 会在指定目标端口时显示内联提示（例如作为 `containerPort` 的值）。 ![端口转发内联提示](https://resources.jetbrains.com.cn/help/img/idea/2026.3/forward_port_inlay_hint.png)

2. 在   转发端口   对话框中：

* 在 地址 字段中，列出要侦听的地址。 使用逗号分隔多个值。

* 在 端口 字段中，按 `<local port>:<remote port>` 格式指定端口。 例如， `8888:5000` 表示侦听本地端口 `8888` ，并向远程端口 `5000` 转发数据或从该端口转发数据。 IntelliJ IDEA 会根据相应 Kubernetes 清单中定义的值自动建议端口映射。 如果清单指定的端口已在本地计算机上使用，IntelliJ IDEA 会递增建议值，直到找到可用端口。 如果指定的值小于 `1024` ，则会向建议的本地端口值加上 8000。 如果手动指定当前已占用的本地端口，IntelliJ IDEA 会在开始转发前通知。

3. 点击   前进  。

![转发端口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_forward_ports_dialog.png)

Procedure: 管理端口转发会话

* 要打开所有活动端口转发会话的视图，请在   服务   工具窗口中展开 Kubernetes 集群下的  `网络 | 端口转发` 。

![端口转发会话列表](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_forward_ports_services_tool_window.png)

> **Tip:**
> 在每个端口转发会话旁，IntelliJ IDEA 会显示一个徽章，表示其当前状态。

* 要终止端口转发会话，请右键点击该会话并选择   停止端口转发  ，或点击工具栏上的 ![停止端口转发](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.run.stop.svg)。

* 要重启端口转发会话，请右键点击该会话并选择   重新启动端口转发  ，或点击工具栏上的 ![停止端口转发](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.resume.svg)。

### 创建 Secret

借助 IntelliJ IDEA ，您可以快速创建 Kubernetes [Secrets](https://kubernetes.io/docs/concepts/configuration/secret/)。

Procedure:

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 选择一个集群并展开   其他 Kubeconfig 路径  。

3. 右键点击   私密  节点并选择   创建新密钥  。 或者，选择   私密   节点并点击工具栏上的 ![添加到书签](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.bookmarks.addBookmarksList.svg)。

4. 在打开的   创建新密钥   窗口中，指定秘密名称、类型和命名空间。 为了加速秘密创建，IntelliJ IDEA 会根据所选 [secret type](https://kubernetes.io/docs/concepts/configuration/secret/#secret-types) 添加所需的数据或注释键。

5. 在   数据  和   注解  部分，点击   值  并输入现有键的值，或者您可以点击 ![添加图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)并选择提供值的方式：

* 手动添加 以手动输入数值。

* 使用文件数据 选择一个文件（例如，SSH 密钥文件或 Docker `config.json` ），以将文件内容用作值。

![创建新的 Secret 窗口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_create_secret_window.png)

您可以在   服务   工具窗口中查看所有的 Secrets，位于   其他 Kubeconfig 路径   下面。 要编辑 Secret，请右键点击它并选择   编辑密钥  ，或点击工具栏上的 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.edit.svg)。

创建 Secret 后，您可以在 Pod 配置文件的  `secretName`  字段中开始输入其名称。 这将为集群或您的项目中可用的 Secret 名称调用补全。

处理引用 Secret 的 YAML 文件时，IntelliJ IDEA 会提供带有操作的 [嵌入提示](inlay-hints.html)，帮助快速检查或重用 Secret 值。

* 显示 ：在弹出窗口中显示引用的 Secret 的解码值。

* 复制 ：将解码后的 Secret 值复制到剪贴板以供临时使用。

![用于显示和复制 Kubernetes Secret 的嵌入提示](https://resources.jetbrains.com.cn/help/img/idea/2026.3/reveal-copy-k8s-secret.png)

这两个操作都会访问并显示 Secret 中定义的真实值，而不是 YAML 中的编码文本或占位符文本。

如果您的账户权限不足，点击该按钮会显示相应的工具提示。 这可以防止受限数据意外暴露。

### 请保持您的集群信息为最新

若要使 IntelliJ IDEA 与您的集群保持同步，请执行以下操作：

* [重新加载配置](#reload-configuration)以获得 kubeconfig 文件的最新更改。

* [刷新资源](#refresh-cluster) 以获取 Kubernetes 资源的最新更改。 只要拥有必要权限，这通常会自动完成。

Procedure: 重新加载配置

默认情况下，当您更改 kubeconfig 文件时，配置会自动重新加载。 您仍然可以手动重新加载它。

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 右键点击集群并选择  `更多 | 重新加载配置` 。

如果您想禁用自动重新加载，请清除   自动重新加载配置  选项。

您还可以在 IDE 设置（ `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))）中检查此设置，在  `构建、执行、部署 | Kubernetes | 集群交互 | 自动重新加载配置` 中。

Procedure: 手动刷新集群资源

如果已 [连接到集群](#connect-to-the-cluster)，对其资源所做的任何更改都会自动反映在 IDE 中。 如果资源未自动更新（因为 [集群角色](https://kubernetes.io/docs/reference/access-authn-authz/rbac/) 缺少权限），则   服务   工具窗口中会显示一条关于禁止自动刷新的消息。 在这种情况下，您可以手动刷新资源。

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 右键点击一组资源并选择   刷新  ，或点击 `Ctrl+F5` (Windows), `⌘ R` (macOS), `⌃ F5` (IntelliJ IDEA Classic (macOS)), `⌘ R` (macOS System Shortcuts), `Ctrl+F5` (XWin), `Ctrl+F5` (GNOME), `Ctrl+5` (KDE), `Ctrl+F5` (Emacs), `Ctrl+F5` (Sublime Text), `⌘ R` (Sublime Text (macOS)), `Ctrl+Alt+R` (Visual Studio), `⌘ ⌥ R` (Visual Studio (macOS)), `Ctrl+F5` (NetBeans), `Ctrl+F5` (Eclipse), `Ctrl+F5` (Eclipse (macOS))。

> **Tip:**
> 使用 [kubectl auth can-i](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_auth/kubectl_auth_can-i/) 命令检查访问权限。 例如，要检查是否允许手动获取有关 Pod 的信息（刷新操作所需），请运行：
>
>
>
>
> ```SHELL
> kubectl auth can-i get pods
>
> ```
>
>
>
> 要检查是否允许获取 Pod 的自动更新，请运行：
>
>
>
>
> ```SHELL
> kubectl auth can-i watch pods
>
> ```

## 日志视图

使用 IntelliJ IDEA，您可以查看集群日志和选定资源的日志。 可以使用筛选器按日期、来源和日志消息中的特定值对其进行筛选。

Procedure: 在编辑器中打开资源日志

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 通过以下方式之一选择日志来源：

* 要打开所有资源的日志视图，请选择 Kubernetes 集群，然后在 服务 工具窗口的工具栏上点击 ![跟踪日志图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-kubernetes.icons.newui.showLogs.svg)（ 跟随日志 ）。 ![日志视图](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_view_all_cluster_logs.png)

* 要打开特定资源的日志视图，请选择该资源，然后在 服务 工具窗口的工具栏上点击 ![跟踪日志图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/clouds-kubernetes.icons.newui.showLogs.svg)（ 跟随日志 ）。 或者，右键点击资源并选择 跟随日志 。 如果 Pod 中存在多个容器，请从显示的容器列表中选择要跟随其日志的容器。 ![日志视图](https://resources.jetbrains.com.cn/help/img/idea/2026.3/kubernetes_follow_logs_new.png)

这将使用  `--follow=true`  标志实时跟踪所选资源的日志，并在新的编辑器标记中打开它们。

Procedure: 管理日志

在使用集群日志视图或所选资源的日志视图时，可以使用主工具栏 (1) 或浮动工具栏 (2) 处理日志输出。 浮动工具栏提供对常用操作的快速访问。

![Kubernetes 日志视图](https://resources.jetbrains.com.cn/help/img/idea/2026.3/view_k8s_logs.png)

* ![滚动到底部图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.scrollDown.svg)（   滚动到末尾  ）：跳转到日志输出末尾。

* ![软换行图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.softWrap.svg)（   自动换行  ）：当编辑器大小调整时，为日志条目启用软换行。

* ![下载日志图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.download.svg)（   下载已筛选的日志  ）：下载当前在编辑器中打开的日志，并考虑任何 [已应用的筛选器](#filter-logs)。

* ![清除日志图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.delete.svg)（   清除显示的日志  ）：清除编辑器中显示的日志条目。 此操作仅影响当前视图。 重新打开同一资源的日志时，这些条目将再次出现。

Procedure: 日志筛选器

[打开日志](#open-logs)后，可以使用编辑器顶部的以下筛选器细化日志列表：

* ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.toolwindows.changes.svg)（   打开模式匹配  ）：输入或选择您希望日志数据匹配的值或模式。 例如，如果您的日志中存在级别信息，您可以选择  `警告` 、  `错误`  或其他级别值，仅显示与这些级别对应的日志。

* ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.filter.svg)（   选择日志源  ）：选择您希望显示日志的集群资源。

* ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.history.svg)（   按日期和时间使用筛选器  ）：选择您希望显示日志的时间范围。

* ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.show.svg)（   选择日志字段  ）：选择是否显示日志时间戳、来源和消息。

> **Tip:**
> 可以在 IDE 设置（ `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))）的  `构建、执行、部署 | Kubernetes | 日志 | 默认日志字段`  下全局配置日志字段的可见性。

* 在编辑器标签顶部的输入字段中，输入日志消息中的值。 点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.inline.regex.svg) 使用正则表达式，点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.inline.matchCase.svg) 使搜索区分大小写。

* ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.actions.clearCash.svg)（   清除所有日志筛选器  ）：丢弃所有已应用的筛选器（来源除外）并显示所有日志。

* 可以为日志条目定义基于正则表达式的高亮显示规则，以识别和区分重要消息，例如错误、警告和信息事件。 在 IDE 设置（ `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))）中的  `构建、执行、部署 | Kubernetes | 日志`  下，使用   筛选器   表来创建和管理规则。 对于每个筛选器，可以指定正则表达式模式，并通过启用粗体、斜体和选择颜色自定义其外观。

Procedure: 下载单个容器的日志

1. 打开 [服务](services-tool-window.html) 工具窗口：转到  `查看 | 工具窗口 | 服务`  或按 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))。

2. 选择一个资源，然后点击右侧工具栏上的 ![下载日志图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.download.svg)（   下载日志  ）以保存日志文件。

Procedure: 配置日志选项

您可以在 IDE 设置（ `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))）的  `构建、执行、部署 | Kubernetes | 日志`  下配置日志选项：

* 如果想要将日志自动保存在 [Scratches](scratches.html) 以外的位置，请在 将日志保存至 中指定一个目录。 或者选择 下载前询问日志的保存位置 ，每次保存日志时提示选择位置。 如需在文件名中包含日志时间戳，请选择 将时间戳附加到日志文件名 。

* 如果需要从 Kubernetes 日志中移除 ANSI 颜色和格式设置编码，并将其显示为纯文本，请选择 从日志中去除 ANSI 代码 。

* 使用 在以下位置显示集群事件 选项，可以选择日志输出的位置：在编辑器或 服务 工具窗口中。

* 默认日志缓存大小为 300 MB。 当超出该限制时，IDE 会通知您。 如果想要更改这些通知的阈值，请在 日志缓存超出限制时发出警告 中输入所需值。

* 如需调整编辑器中日志更新的频率，请在 日志编辑器更新延迟(以毫秒为单位) 中指定延迟时间（以毫秒为单位）。

## 自定义资源定义支持

如果您使用 [自定义资源](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/) 扩展 Kubernetes 集群，IntelliJ IDEA 可以通过  自定义资源定义  (CRD) 规范对它们进行验证。

Procedure: 指定 CRD 规格路径

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)) 打开设置，然后选择  `构建、执行、部署 | Kubernetes | 模式` 。

2. 在   CRD 和 OpenAPI 规范   表中，点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)，然后选择本地 CRD 文件或指定 URL。 然后点击   OK  。

使用 ![“向上”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.moveUp.svg) 和 ![“向下”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.moveDown.svg) 重新排列 CRD 文件列表。 当存在冲突的定义时，此项会定义优先级：IntelliJ IDEA 将使用最低优先级的定义，如果它在多个文件中定义。

默认情况下，CRD 仅应用于当前项目。 如果您希望某个 CRD 在您使用此 IDE 实例打开的任意项目中可用，请将   作用域:   选项更改为  `IDE` 。

> **Note:**
> 当您应用更改时，IntelliJ IDEA 会自动从指定的 URL 下载新增的 CRD。 它将仅在模型重新加载时下载其他已修改的 CRD，这会在您打开项目或更改其他 Kubernetes 设置（例如 CRD 的顺序）时发生，并且距离上次模型重新加载已超过三小时。 如果距离上次模型重新加载不到三小时，您可以使用   重置架构缓存   按钮强制重新加载当前模型。

要从正在运行的 Kubernetes 集群加载 CRD，请启用   如可用，从活动集群中使用 API 架构  。

> **Tip:**
> 默认情况下，CRD 文件的最大大小限制为 50 MB。 可以在  `设置 | 高级设置 | Kubernetes | 加载 CRD YAML 文件的最大大小`  中更改此限制。

您可以在   Kubernetes   节点下的 [服務](services-tool-window.html#kubernetes) 工具窗口中查看当前集群的 CRD，包括其所有应用资源。

Kubernetes 插件支持以下类型的 CRD 文件：

### YAML 中的 CustomResourceDefinition 文件

以下示例展示了一种简单的 [CustomResourceDefinition](https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/)规范，用于一种自定义资源  `stable.example.com/v1` 的类型  `CronTab` 。 标识资源的必填字段是  `metadata.name` 、  `spec.group` 、  `spec.versions` 和  `spec.names` 。

> **Note:**
> 目前，并非所有来自 OpenAPI 架构的字段都可以用于验证（请参见示例中的  `pattern` 、  `minimum`  和  `maximum`  字段下的  `validation.openAPIV3Schema` ）。 有关更多信息，请参阅 [CRD 校验限制](#restrictions)。

```YAML
apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition
metadata:
  name: crontabs.stable.example.com # Obligatory field to identify the resource
spec:
  group: stable.example.com # Obligatory field to identify the resource
  versions: # Obligatory field to identify the resource
    - name: v1
      served: true
      storage: true
  scope: Namespaced
  names: # Obligatory field to identify the resource
    plural: crontabs
    singular: crontab
    kind: CronTab
    shortNames:
      - ct
validation:
  openAPIV3Schema: # Schema for validating custom objects
    properties:
      spec:
        properties:
          cronSpec:
            type: string
            pattern: '^(\d+|\*)(/\d+)?(\s+(\d+|\*)(/\d+)?){4}$' # not supported for validation
          replicas:
            type: integer
            minimum: 1 # not supported for validation
            maximum: 10 # not supported for validation

```

### OpenAPI v2.0 模式（JSON格式）

以下示例展示了一个简单的 [OpenAPI v2.0](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md)模式，其中包含了自定义资源  `sample/v1` 的  `配置` 的 CRD 规范。 自定义资源的根定义必须包含  `x-kubernetes-group-version-kind`  字段，并指定组、版本和种类。 在此示例中，  `root.Definition`  对象使用  `构建`  属性来引用  `some.Definition`  对象。

```JSON
{
    "swagger": "2.0",
    "info": {
        "title": "Sample Schema",
        "version": "sample/v1"
    },
    "paths": {},
    "definitions": {
        "some.Definition": {
            "description": "Example of a definition.",
            "properties": {
                "someProperty": {
                    "type": "string"
                }
            }
        },
        "root.Definition": {
            "description": "This is the root definition for the resource",
            "properties": {
                "build": {
                    "$ref": "#/definitions/some.Definition"
                }
            },
            "x-kubernetes-group-version-kind": [
                {
                    "group": "sample",
                    "kind": "Config",
                    "version": "v1"
                }
            ]
        }
    }
}

```

### CRD 校验限制

IntelliJ IDEA 不支持以下 OpenAPI v3 模式功能：

* `multipleOf`

* `maximum`

* `exclusiveMaximum`

* `minimum`

* `exclusiveMinimum`

* `最大长度`

* `minLength`

* `pattern`

* `maxItems`

* `minItems`

* `uniqueItems`

* `maxProperties`

* `minProperties`

* `allOf`

* `oneOf`

* `anyOf`

* `not`

* `format`

* `默认`

* `nullable`

* `只读`

* `writeOnly`

* `xml`

* `externalDocs`

* `example`

* `已弃用`

## 效率提示

如果您经常使用此处描述的功能，以下提示可能会对您有所帮助：

Procedure: 分配快捷键

您可以为 Kubernetes 操作分配一个键盘快捷键。

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))）中，选择   按键映射  。

2. 在搜索字段中输入  `kubernetes` ，然后双击一个操作以为其设置快捷方式。

或者，您可以使用   查找操作  对话框 `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))，输入所需的操作，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))。

例如，您可以分配一个快捷键给   与集群交互  ，以便在 [修改](#cluster_resources)资源配置文件时快速打开上下文菜单。

Procedure: 配置代码折叠

默认情况下，IntelliJ IDEA 使用 [代码折叠](working-with-source-code.html#code_folding)在 Helm 模板和 Kubernetes 配置文件中将值引用和定义呈现为实际值。 您可以点击该值将其展开，或按 `Ctrl+NumPad +` (Windows), `⌘ NumPad +` (macOS), `⌘ NumPad +` (IntelliJ IDEA Classic (macOS)), `⌘ NumPad +` (macOS System Shortcuts), `Ctrl+NumPad +` (XWin), `Ctrl+NumPad +` (GNOME), `Ctrl+NumPad +` (KDE), `Ctrl+NumPad +` (Emacs), `Ctrl+Shift+]` (Sublime Text), `⌘ ⌥ ]` (Sublime Text (macOS)), `Ctrl+M, E` (Visual Studio), `⌃ M, E` (Visual Studio (macOS)), `Ctrl+NumPad +` (NetBeans), `Ctrl+NumPad +` (Eclipse), `⌘ NumPad +` (Eclipse (macOS)) 和 `Ctrl+NumPad -` (Windows), `⌘ NumPad -` (macOS), `⌘ NumPad -` (IntelliJ IDEA Classic (macOS)), `⌘ NumPad -` (macOS System Shortcuts), `Ctrl+NumPad -` (XWin), `Ctrl+NumPad -` (GNOME), `Ctrl+NumPad -` (KDE), `Ctrl+NumPad -` (Emacs), `Ctrl+Shift+[` (Sublime Text), `⌘ ⌥ [` (Sublime Text (macOS)), `Ctrl+M, S` (Visual Studio), `⌃ M, S` (Visual Studio (macOS)), `Ctrl+NumPad -` (NetBeans), `Ctrl+NumPad -` (Eclipse), `⌘ NumPad -` (Eclipse (macOS)) 来切换折叠。 如果您希望默认情况下查看扩展的引用和定义，请执行以下操作：

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))）中，选择  `编辑器 | 常规 | 代码折叠` 。

2. 在   代码折叠  页面上，清除必要的复选框：

* Kubernetes：Helm 模板中的值引用

* Kubernetes：YAML 文件中的 EnvVar 定义

* Kubernetes：YAML 文件中的 ExecAction 定义

