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

## 概述

`derive` 用于将内容标记为可静态分析，以便 GT CLI 在构建时提取所有可能的翻译条目。

它是一个**恒等函数**——也就是说，它会原样返回你传入的内容。它的作用是作为静态分析的标记。

```python
from gt_flask import derive, t  # 或从 gt_fastapi 导入

message = t(f"The {derive('boy' if gender == 'male' else 'girl')} is playing.")
```


## 参考

### 参数

<TypeTable
  type={{
  "content": {
    type: 'object',
    description: '一种静态表达式，其可能值集合是有限的。',
  },
}}
/>

### 返回值

原样返回 `content`。该函数本身不做任何处理，只是作为 CLI 的标记。

***

## 注意事项

* 所有可能的结果都必须能在构建时静态分析
* `derive` 中的动态内容 (用户输入、API 数据) 应使用 [`declare_var`](/docs/python/api/declare-var) 包装
* 使用 [`decode_vars`](/docs/python/api/decode-vars) 从已声明的变量中提取原始值
* 详见 [derive 教程](/docs/python/tutorials/derive)，了解详细示例和用法模式