GitLab CI/CD
IntelliJ IDEA 可识别 .gitlab-ci.yml 文件并提供编码辅助,您可以在其中为 GitLab CI/CD 流水线定义指令。 有关更多详细信息,请参阅 GitLab 文档。
启用 GitLab 插件
此功能依赖于 GitLab 插件,在 IntelliJ IDEA 中默认捆绑并启用。 如果相关功能不可用,请确保您没有禁用插件。
按 Ctrl+Alt+S 打开设置,然后选择 。
打开 已安装 选项卡,找到 GitLab 插件,然后勾选插件名称旁边的复选框。
Features
支持以下功能:
IntelliJ IDEA 为 GitLab CI/CD 配置文件的所有组件提供语法高亮显示。 您可以为配置的不同部分自定义配色方案:
配置文件的 YAML 结构:
IntelliJ IDEA 帮助您实时检测 GitLab CI/CD 配置文件中的配置问题。 包括重复 job 使用、未定义的 job 和未定义的阶段。
获取流水线配置语法、关键字和 CI/CD 变量的补全建议。

在 CI/CD 配置文件中快速在
stage和job的声明与用法之间跳转。将鼠标悬停在符号上或使用 文档 工具窗口(Ctrl+Q )查看快速文档,包括指向官方 GitLab CI 参考的链接。

在您的配置文件中直接搜索
stage和job符号的用法。您可以通过应用重命名重构(Shift+F6 ),更改
stage和job符号的声明和使用中的名称。检测 Shell 脚本语言注入
IntelliJ IDEA 会自动检测配置文件中
before_script、script和after_script块中的 Shell 脚本注入,并将其标记为 注入语言:Shell 脚本。 IDE 会将这些代码片段视为完整功能的 Shell 脚本。 您可以编辑 Shell 脚本片段,对其进行解释,并享受语言特定功能,如语法高亮和代码补全。您可以在配置文件中注入的部分使用 switch shell 脚本注入 意图操作来禁用此行为。 请注意,开启或关闭 Shell 脚本注入会影响整个项目。

故障排除
缺少编码辅助功能
为确保对 GitLab CI/CD 的完整支持,请检查您的 .gitlab-ci.yml 文件是否使用了正确的 JSON 模式。
IntelliJ IDEA 会自动加载一组常用模式,包括 GitLab 的 CI 模式(通常命名为 gitlab-ci)。
如果代码补全、检查或导航等功能缺失或未按预期工作,可能是 JSON 模式配置的问题。
配置 JSON 模式
在编辑器中打开 .gitlab-ci.yml 文件,并在右下角检查 JSON 模式小部件。 确保已选择
gitlab-ci。
如果未列出该模式:
请从 https://gitlab.com/gitlab-org/gitlab/-/raw/master/app/assets/javascripts/editor/schema/ci.json 手动下载。
在 IntelliJ IDEA 中,前往 并 添加自定义 JSON 模式映射。
使用 JSON 模式小部件将添加的模式分配给您的 .gitlab-ci.yml 文件。