# GitLab CI/CD

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

CLion 可识别并为  `.gitlab-ci.yml`  文件提供编码辅助，您可以在其中为 GitLab CI/CD 流水线定义指令。 有关更多详细信息，请参阅 [GitLab 文档](https://docs.gitlab.com/topics/build_your_application/)。

## 功能

支持以下功能：

* [语法高亮](configuring-colors-and-fonts.html) CLion 为 GitLab CI/CD 配置文件的所有组成部分提供语法高亮显示。 您可以自定义配置各部分的配色方案： * 配置文件的 YAML 结构： `设置 | 编辑器 | 配色方案 | YAML` * [CI/CD 变量表达式](https://docs.gitlab.com/ci/jobs/job_rules/#cicd-variable-expressions)： `设置 | 编辑器 | 配色方案 | GitLab CI 表达式` * [Shell 脚本注入](#shell-injections)： `设置 | 编辑器 | 配色方案 | Shell 脚本`

* [检查](https://www.jetbrains.com/zh-cn/help/inspectopedia/GitLab-CI-CD.html) CLion 可帮助您实时检测 GitLab CI/CD 配置文件中的配置问题。 包括重复使用 job、未定义的 job 和未定义的 stage。

* [代码补全](auto-completing-code.html) 获取管道配置语法、关键字和 CI/CD 变量的补全建议。 ![管道配置语法的代码补全](https://resources.jetbrains.com/help/img/idea/2026.3/gitlab-ci-completion.png)

* [代码导航](navigating-through-the-source-code.html#go_to_declaration) 在 CI/CD 配置文件中快速导航到 `stage` 和 `job` 的声明和用法之间。

* [快速文档](null) 将鼠标悬停在符号上，或使用 文档 工具窗口（ `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS))）查看快速文档，包括指向官方 GitLab CI 参考文档的链接。 ![GitLab CI 配置的快速文档](https://resources.jetbrains.com/help/img/idea/2026.3/gitlab-ci-quick-doc.png)

* [查找用法](find-highlight-usages.html) 直接在配置文件中搜索 `stage` 和 `job` 符号的用法。

* [重命名重构](rename-refactorings.html) 您可以通过应用重命名重构（ `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `⌘ ⌃ E` (Xcode), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `F2` (ReSharper), `F2` (ReSharper (macOS)), `Ctrl+Shift+R` (QtCreator), `⌘ ⌃ R` (QtCreator (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS))）来更改 `stage` 和 `job` 符号在声明和使用中的名称。

* Shell 脚本语言注入检测 CLion 会自动检测配置文件中 `before_script` 、 `script` 和 `after_script` 块中的 Shell 脚本注入，并将其标记为 已 inject 的语言: shell 脚本 。 IDE 将这些代码片段视为功能完整的 Shell 脚本。 您可以编辑 Shell 脚本片段，对其进行解释，并使用语言特定功能，如语法高亮和代码补全。 您可以在配置文件的注入部分使用 切换 shell 脚本注入 意图操作来禁用此行为。 请注意，启用或禁用 Shell 脚本注入会影响整个项目。 ![GitLab CI 配置文件中的 Shell 脚本注入](https://resources.jetbrains.com/help/img/idea/2026.3/shell-script-injection-gitlab-ci.png)

## 故障排查

### 缺失的代码辅助功能

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

CLion 会自动加载一组常用架构，包括 GitLab 的 CI 架构（通常命名为  `gitlab-ci` ）。

如果代码补全、检查或导航等功能缺失或无法按预期工作，可能是由于 JSON 架构配置问题引起的。

Procedure: 配置 JSON 架构

* 在编辑器中打开  `.gitlab-ci.yml`  文件，并检查右下角的 JSON 架构小部件。 确保已选择  `gitlab-ci` 。

![JSON 架构小部件](https://resources.jetbrains.com/help/img/idea/2026.3/gitlab-ci-json-schema.png)

* 如果架构未列出：

1.  从 [https://gitlab.com/gitlab-org/gitlab/-/raw/master/app/assets/javascripts/editor/schema/ci.json](https://gitlab.com/gitlab-org/gitlab/-/raw/master/app/assets/javascripts/editor/schema/ci.json) 手动下载。

2.  在 CLion 中，转到  `设置 | 语言＆框架 | 架构和 DTD | JSON 架构映射`  并 [添加自定义 JSON 架构映射](json.html#ws_json_schema_add_custom_procedure)。

3.  使用 JSON 架构小部件将添加的架构分配给  `.gitlab-ci.yml`  文件。

