# 变量与表达式

使用变量可以创建可重用的文本，该文本可以在 [表达式](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/formatting/inline#expressions) 并且 [自适应内容的条件中被有条件地引用](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/fa-bu-wen-dang/adaptive-content/adapting-your-content#working-with-the-condition-editor).&#x20;

如果您在内容中多次重复相同的名称、短语或版本号，您可以创建一个 **表达式允许您动态显示在一个** 以帮助保持所有这些实例的同步和准确——如果您需要更新它们，或它们复杂且经常拼写错误，这将非常有用。

您可以创建作用域为单个页面或单个空间的变量。

### 创建新变量

要创建新变量，请点击 **变量** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FLm9dLFUy5c3i4YOEwvSz%2Fvariables.svg?alt=media&#x26;token=ae18f815-541c-4b17-ae42-9c4d90897899" alt=""></picture> 在编辑已打开的 [变更请求](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/xie-zuo/change-requests)的右上角的图标。 这将打开变量侧边栏。

您可以使用顶部的切换来查看并创建作用域为当前页面或当前空间内所有页面的变量。

点击 **创建变量** 将打开一个模式对话框，您可以在其中为变量命名并设置其值。

点击 **添加变量** 以保存您的变量。

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FmyWu2r6UfxkMRCjcDZuc%2Fvariables.jpg?alt=media&#x26;token=40408b2f-bdb2-41bd-9763-bc8caf3bfd40" alt="A GitBook screenshot showing the Add variables screen. The variable Name box has been filled with the text ‘latest_version’ and the Value box has been filled with the text ‘v3.04.1’"><figcaption><p>您可以将变量添加到单个页面或整个空间。 当您更新变量的值时，其每个实例都会更新。</p></figcaption></figure>

{% hint style="info" %}
变量名必须以字母开头，并且可以包含字母、数字和下划线。
{% endhint %}

### 在内容中使用变量

变量可以在一个 [表达式](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/formatting/inline#expressions) 中被引用并使用——您可以将其内联插入到内容中。 插入表达式后，双击它以打开表达式编辑器。

在您页面下定义的变量可在 `page.vars` 对象下访问。 类似地，在整个空间中定义的变量可在 `space.vars` 对象来定义。&#x20;

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FAYoxSMGR9BAtkV9aBszX%2Finsert-variables-expression.jpg?alt=media&#x26;token=ece25501-bfa2-4da8-82c1-f4e4f7ba3f89" alt="A GitBook screenshot showing an expression block within the editor. The expression editor is open below it and the ‘space.vars.latest_version’ variable has been selected"><figcaption><p>下访问。您可以在表达式中向内容添加变量。表达式编辑器提供自动完成选项，帮助您找到所需的变量。</p></figcaption></figure>

### 更新变量

在变更请求期间的任何时候，您都可以更新变量。更新其值将更新引用该变量的任何表达式块中的值。一旦变更请求合并，已更改的变量将在任何已发布的网站上生效。
