# GitHub Actions

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

GitHub Actions 是一个持续集成与持续交付（CI/CD）平台，可让您自动化构建、测试与部署流程。 CLion 能识别 GitHub YAML 文件并为其提供代码辅助功能。 其中包括存储于  `.github/workflows`  目录中的 workflow 文件和存储于  `.github/actions`  目录中的 action 文件。 如需详细信息，请参阅 [GitHub Actions 文档](https://docs.github.com/en/actions)。

> **Tip:**
> 要确保已启用 GitHub 操作支持，请转到  `设置 | 高级设置`  并检查是否已选择   GitHub Actions 编写支持(需要重启 IDE)   选项。

CLion 支持以下功能以便处理 GitHub 文件：

* [语法高亮](configuring-colors-and-fonts.html) CLion 为文件的 YAML 结构提供语法高亮显示。 您可以在 `设置 | 编辑器 | 配色方案 | YAML` 中自定义配色方案。

*

* [检查](https://www.jetbrains.com/zh-cn/help/inspectopedia/GitHub-actions.html) 您可以在 GitHub 文件中检测循环作业依赖关系、无效参数或标准库函数调用、未定义的 action 或文件引用、未定义的作业依赖关系以及未定义的参数。 ![检查示例：未定义的作业依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/github-actions-inspection-example.png) 您可以在 设置 对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中的 `编辑器 | 检查 | GitHub 操作` 下管理 GitHub Actions 检查项。

* [代码补全](auto-completing-code.html) CLion 提供强大的补全支持，帮助您更快速地编写 GitHub workflow 与 action。 包括以下内容： * 支持 GitHub Actions 各种上下文的补全，包括 `github.*` 、 `env.*` 、 `steps.*` 和 `inputs.*` 。 这简化了复杂 workflow 的脚本编写过程，并减少了寻找特定上下文语法和参数所花费的时间。 [Video](https://resources.jetbrains.com/help/img/idea/2026.3/github-workflow-context-completion.mp4) * `needs` 和 `runs-on` 属性的作业依赖关系补全。 * YAML 结构建议。 * 为本地 action 以及发布在 GitHub 上 `actions` 组织中的 action 提供参数、名称和版本的自动补全。 * 支持 CRON 表达式，可对计划任务提供验证与补全功能。 ![GitHub 文件中的 CRON 表达式](https://resources.jetbrains.com/help/img/idea/2026.3/cron-github-yaml.png) * 提供 Docker 镜像与标签建议，以便将 Docker 容器集成到您的 action 中。 * JavaScript 文件路径补全。 * 在 `action.yml` 中支持标识功能，允许您为 GitHub Marketplace 与 workflow 中的 action 指定图标与颜色以实现可视化区分。 [Video](https://resources.jetbrains.com/help/img/idea/2026.3/github-actions-branding.mp4)

* [代码导航](navigating-through-the-source-code.html) 您可以在 GitHub Actions 文件中快速在符号的声明和使用之间跳转。

* [快速文档](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))）查看快速文档。

Procedure: 创建新的 GitHub workflow

> **Note:**
> CLion 仅允许您在  `.github/workflows`  目录中创建 GitHub workflow 的 YAML 文件。

1. 在   项目   工具窗口中，右键点击  `.github/workflows`  目录并选择   新建  （或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))）。 然后，选择   GitHub 工作流   文件类型。

2. 在   新建 GitHub 工作流文件   对话框中，指定文件名并按下 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

Procedure: 创建新的 GitHub action

> **Note:**
> CLion 仅允许您在  `.github/actions`  目录中创建 GitHub action 的 YAML 文件。

1. 在   项目   工具窗口中，右键点击  `.github/actions`  目录并选择   新建  （或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))）。 然后，选择   GitHub Action   文件类型。

2. 在   新建 GitHub 操作文件   对话框中，指定文件名并按下 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

