DataSpell 2025.2 Help

GitLab CI/CD

DataSpell 可识别 .gitlab-ci.yml 文件,并为其提供代码辅助功能,您可以在这些文件中定义 GitLab CI/CD 流水线的指令。有关详细信息,请参阅 GitLab 文档。 有关详细信息,请参阅 GitLab 文档

功能

支持以下功能:

  • 语法高亮

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

    • 配置文件的 YAML 结构:

      设置 | 编辑器 | 配色方案 | YAML

    • CI/CD 变量表达式

      设置 | 编辑器 | 配色方案 | GitLab CI 表达式

    • Shell 脚本注入

      设置 | 编辑器 | 配色方案 | Shell 脚本

  • 检查

    DataSpell 可实时帮助您发现 GitLab CI/CD 配置文件中的配置问题。 包括重复的作业使用情况、未定义的作业和未定义的阶段。

  • 代码补全

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

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

    在 CI/CD 配置文件中,快速在 stagejob 的声明与使用之间导航。

  • 快速文档

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

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

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

  • 重命名重构

    您可以通过执行重命名重构(Shift+F6 ),修改 stagejob 符号在声明和使用中的名称。

  • 检测 Shell 脚本语言注入

    DataSpell 会自动检测配置文件中 before_scriptscriptafter_script 块中的 Shell 脚本注入,并将其标记为 注入语言:Shell Script。 IDE 将这些代码片段视为功能完整的 Shell 脚本。 您可以编辑 Shell 脚本片段,对其进行解释,并使用语言特定功能,例如语法高亮和代码补全。

    您可以在配置文件中注入部分使用 switch shell 脚本注入 意图操作来禁用此行为。 请注意,启用或禁用 Shell 脚本注入将影响整个项目。

    GitLab CI 配置文件中的 Shell 脚本注入

故障排除

缺失的代码辅助功能

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

DataSpell 会自动加载一组常用模式,包括 GitLab 的 CI 模式(通常命名为 gitlab-ci)。

如果代码补全、检查或导航等功能缺失或未按预期工作,可能是 JSON 模式配置的问题。

配置 JSON 模式

最后修改日期: 2025年 9月 27日