# GitHub Actions

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

GitHub Actions 是一个持续集成与持续交付（CI/CD）平台，可用于自动化构建、测试和部署流水线。 IntelliJ IDEA 可识别 GitHub 的 YAML 文件，并为其提供编码辅助。 这包括存储在您存储库的  `.github/workflows`  目录中的工作流文件，以及存储在  `.github/actions`  目录中的操作文件。 有关详细信息，请参阅 [GitHub Actions 文档](https://docs.github.com/en/actions)。

Procedure: 启用 GitHub 插件

此功能依赖于 [GitHub](https://plugins.jetbrains.com/plugin/13115-github) 插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

1. 按 `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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  GitHub  插件并点击   启用  。

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

IntelliJ IDEA 在处理 GitHub 文件时支持以下功能：

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

*

* [检查](https://www.jetbrains.com.cn/help/inspectopedia/GitHub-actions.html) 您可以在 GitHub 文件中检测循环作业依赖项、无效参数或标准库函数调用、未定义的操作或文件引用、未定义的作业依赖项以及未定义的参数。 ![检查示例：未定义的作业依赖项](https://resources.jetbrains.com.cn/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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）的 `编辑器｜检查｜GitHub 操作​​` 下管理 GitHub Actions 检查。

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

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

* [快速文档](viewing-reference-information.html) 将鼠标指针悬停在符号上，或使用 文档 工具窗口（ `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)), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS))）查看快速文档。

Procedure: 创建新的 GitHub 工作流

> **Note:**
> IntelliJ IDEA 仅允许您在  `.github/workflows`  目录中为 GitHub 工作流创建 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)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (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)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

Procedure: 创建新的 GitHub 操作

> **Note:**
> IntelliJ IDEA 仅允许您在  `.github/actions`  目录中为 GitHub 操作创建 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)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))）。 然后，选择   GitHub 操作​​   文件类型。

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

