---
date: "2024-04-10T22:21:00+08:00"
slug: "actions-variables"
sidebar_position: 25
---

# 变量

您可以建立使用者、組織和存放庫级别的变量。变量的级别取决于建立它的位置。当建立变量时，变量的名稱会被
转换為大写，在yaml文件中引用时需要使用大写。

## 命名規則

以下規則适用于变量名：

- 变量名稱只能包含字母数字字符 (`[a-z]`, `[A-Z]`, `[0-9]`) 或下划线 (`_`)。不允许使用空格。
- 变量名稱不能以 `GITHUB_` 和 `GITEA_` 前缀開頭。
- 变量名稱不能以数字開頭。
- 变量名稱不区分大小写。
- 变量名稱在建立它们的级别上必須是唯一的。
- 变量名稱不能為 `CI`。

## 使用

建立配置变量后，它们将自动填充到 `vars` 上下文中。您可以在工作流中使用类似 `${{ vars.VARIABLE_NAME }}` 这样的表达式来使用它们。

## 优先级

如果同名变量存在于多个级别，则级别最低的变量优先。
存放庫级别的变量总是比組織或者使用者级别的变量优先被選中。
