GitLab CI/CD
PhpStorm 识别并为 .gitlab-ci.yml 文件提供编码辅助,您可以在其中为 GitLab CI/CD 流水线定义指令。 有关更多详情,请参阅 GitLab 文档。
功能
支持以下功能:
PhpStorm 为 GitLab CI/CD 配置文件的所有组件提供语法高亮。您可以为配置的不同部分自定义配色方案: 您可以为配置的不同部分自定义配色方案:
配置文件的 YAML 结构:
PhpStorm 可帮助您实时检测 GitLab CI/CD 配置文件中的配置问题。 包括重复作业使用、未定义作业和未定义阶段。
获取流水线配置语法、关键字和 CI/CD 变量的补全建议。

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

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

故障排查
缺失的编码辅助功能
为确保完全支持 GitLab CI/CD,请确认配置文件 .gitlab-ci.yml 使用了正确的 JSON 架构。
PhpStorm 会自动加载常见架构集,包括 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 手动下载。
在 PhpStorm 中,前往 并 添加自定义 JSON 架构映射。
通过 JSON 架构小部件将已添加的架构分配给 .gitlab-ci.yml 文件。