Kubernetes插件需手动启用且仅Ultimate版支持，官方兼容K8s 1.26–1.34版本；配置须分别在Languages & Frameworks和Build, Execution, Deployment中设置API版本与kubeconfig路径，Services工具窗口依赖后者连接集群并需手动刷新。
确认 Kubernetes 插件已启用且版本兼容
IntelliJ IDEA 的 Kubernetes 功能不是开箱即用的“默认可用”功能——它依赖插件，且仅 Ultimate 版支持。如果你在 Settings > Plugins 里找不到 Kubernetes 插件，或插件列表中显示“Not installed”，说明你正在使用 Community 版，必须升级到 Ultimate 才能继续。
即使装了插件，也要注意版本约束：官方明确支持 Kubernetes 1.26 到 1.34。如果你的集群是 1.25 或 1.35+，IDEA 可能无法正确解析 CRD 或校验资源字段，表现为 YAML 编辑时无补全、kdep 模板展开后缺失字段、或 Check configuration 报 “API version not supported”。此时不要强行降级/升级集群，先用 kubectl get nodes 确认真实版本，再比对插件支持范围。
- 插件路径：
Settings > Plugins > Installed，搜索Kubernetes，确保复选框已勾选 - Ultimate 版验证方式：菜单栏
Help > About中显示 “Ultimate” 字样 - 插件自动更新不等于 Kubernetes API 支持更新——新版插件仍可能不兼容新 K8s 版本
配置 kubeconfig 文件路径与作用域
IDEA 不会自动读取所有 KUBECONFIG 环境变量指向的文件，也不扫描 $HOME/.kube/config 以外的路径。如果你的配置文件不在默认位置（比如放在项目根目录 ./k8s/config），必须显式指定，否则 Services 工具窗口始终为空。
关键点在于：配置入口有两个，且作用不同——Settings > Languages & Frameworks > Kubernetes 用于定义资源识别和模板补全（如 kser、kdep），而 Settings > Build, Execution, Deployment > Kubernetes 才真正控制连接行为和 Services 视图的数据源。漏配后者，等于没连上集群。
- 在
Build, Execution, Deployment > Kubernetes中，Path to kubeconfig file必须指向一个可读、含有效凭据的文件；点击Check Configuration后提示Checked successfully才算通过 -
Languages & Frameworks > Kubernetes下的Kubernetes API version应设为集群实际版本（如v1.32），而非插件支持范围的上下限 - 多个 config 文件？用
KUBECONFIG=/path/to/a:/path/to/b合并环境变量，但 IDEA 只认第一个路径；如需切换，得在设置里手动改路径
在 Services 工具窗口中查看和操作资源
Services 工具窗口是 IDEA 管理 Kubernetes 的主界面，但它不会自动刷新。Pod 状态卡在 Pending 或列表为空，不一定是配置失败，更可能是缓存未更新或权限不足导致资源拉取失败。
常见表现：kubectl get pods -A 能看到资源，但 IDEA 里一片空白；右键 Pod 无 Attach Busybox 选项；点击日志图标报 “Connection refused”。这些基本都指向同一个原因：当前 kubeconfig 中的用户没有 list 权限，或 context 指向了无资源的 namespace。
- 打开方式：
View > Tool Windows > Services或快捷键Alt+8 - 首次加载慢？右键集群节点 →
Reload强制刷新，避免等自动轮询 - 想看特定 namespace？右键集群 →
Change Context，选择带目标 namespace 的 context（不是 cluster 名） -
Attach Busybox失败？检查 Pod 是否处于Running状态，且所在节点有kubectl debug权限（需要securitycontextconstraints或podsecuritypolicy允许）
调试时临时容器不生效的排查重点
用 Attach Busybox 调试 Pod 是最常用操作，但失败率高。根本原因往往不是 IDEA 配置错，而是底层 kubectl debug 命令被集群策略拦截，或镜像拉取失败。
典型错误信息：Error from server (Forbidden): pods "xxx" is forbidden: unable to validate against any pod security policy，或控制台输出 Unable to attach to container: failed to create debug container。这时候改 IDEA 设置毫无意义，得查集群侧限制。
- 确认集群启用了
EphemeralContainers特性门控（K8s1.23+默认开启，但某些托管集群如 EKS 1.28 仍需手动启用） - BusyBox 镜像是否被镜像仓库策略拦截？可在终端执行
kubectl debug -it <pod-name> --image=busybox:1.36</pod-name>测试 - 如果用自定义镜像，
Executable字段必须填绝对路径，比如/bin/bash，不能只写bash - 临时容器启动后立即退出？说明容器内命令执行完就结束——IDEA 的控制台只维持交互式 Shell，非守护进程
kubectl 和 helm 命令的 UI 层。当功能异常时，优先在终端复现对应命令（比如 kubectl get ns、kubectl debug），再比对 IDEA 日志（Help > Show Log in Explorer）里的实际调用参数——这才是定位问题最快的方式。 
