# python: declare_var
URL: https://generaltranslation.com/zh/docs/python/api/declare-var.mdx
---
title: declare_var
description: declare_var 函数的 API 参考文档
---

## 概述

`declare_var` 会用 GT 变量标记包裹动态值，以便翻译引擎在译文中保留该变量。

```python
from gt_flask import declare_var  # 或从 gt_fastapi import declare_var

greeting = declare_var("Alice", name="user")
```


## 参考

### 参数

<TypeTable
  type={{
  "variable": {
    type: 'str | int | float | bool | None',
    description: '要作为不可翻译变量嵌入的值。',
  },
  "name?": {
    type: 'str',
    optional: true,
    description: '可选的、人类可读的变量名。',
  },
}}
/>

### 返回值

`str` — 一个 ICU `select` 构造，用于将该值包装为 GT 变量标记。

***

## 说明

* 对于在 runtime 时会变化的值 (例如用户名、计数) ，请使用 `declare_var`。
* 对于在 build time 已知的值，另请参见 [`derive`](/docs/python/api/derive)。
* 使用 [`decode_vars`](/docs/python/api/decode-vars) 从已标记的字符串中将这些变量提取出来。