llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

GitLab CI/CD

IntelliJ IDEA 可识别 .gitlab-ci.yml 文件并为其提供编码辅助,您可以在其中为 GitLab CI/CD 流水线定义指令。 有关更多详细信息,请参阅 GitLab 文档。

启用 GitLab 插件

此功能性依赖于 GitLab 插件,该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用,请确保您没有禁用插件。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 插件。

  2. 找到 GitLab 插件并点击 启用。

功能

支持以下功能:

  • 语法高亮

    IntelliJ IDEA 为 GitLab CI/CD 配置文件的所有组件提供语法高亮显示。 可以为配置的不同部分自定义配色方案:

  • 检查

    IntelliJ IDEA 可帮助实时检测 GitLab CI/CD 配置文件中的配置问题。 这包括重复的作业用法、未定义的作业和未定义的阶段。

  • 代码补全

    获取流水线配置语法、关键字和 CI/CD 变量的补全建议。

    流水线配置语法的代码补全
  • 代码导航

    在 CI/CD 配置文件中快速在 stage 和 job 的声明与用法之间导航。

  • 快速文档

    将鼠标悬停在符号上,或使用 文档 工具窗口(Ctrl+Q )查看快速文档,其中包括指向官方 GitLab CI 参考的链接。

    GitLab CI 配置的快速文档
  • 查找用法

    直接在配置文件中搜索 stage 和 job 符号的用法。

  • 重命名重构

    可以通过应用重命名重构(Shift+F6 )更改声明和用法中 stage 和 job 符号的名称。

  • Shell 脚本语言注入检测

    IntelliJ IDEA 会自动检测配置文件的 before_script、 script 和 after_script 块中的 shell 脚本受限标识符,并将其标记为 Inject 语言:Shell 脚本。 IDE 会将这些代码段视为功能完整的 Shell 脚本。 可以编辑 shell 脚本片段、解释它们,并受益于特定于语言的功能,例如语法高亮显示和代码补全。

    可以在配置文件的 injected 部分使用 switch shell 脚本注入 意图操作禁用此行为。 请注意,开启或关闭 shell 脚本受限标识符会影响整个项目。

    GitLab CI 配置文件中的 shell 脚本受限标识符

故障排除

缺失的编码辅助功能

为确保完全支持 GitLab CI/CD,请检查 .gitlab-ci.yml 文件是否使用了正确的 JSON 架构。

IntelliJ IDEA 会自动加载热门架构设置,包括 GitLab 的 CI 架构(通常名称为 gitlab-ci)。

如果代码补全、检查或导航等功能缺失或未按预期工作,问题可能与 JSON 架构配置有关。

配置 JSON 架构

2026年 11月 3日