# General Translation Python SDKs: set_i18n_manager
URL: https://generaltranslation.com/zh/docs/python/reference/functions/set-i18n-manager.mdx
---

title: set_i18n_manager
description: 在 General Translation Python 中注册当前的 I18nManager。set_i18n_manager 的 API 参考。

---

将一个 [`I18nManager`](/docs/python/reference/classes/i18n-manager) 注册为模块级单例，供翻译函数读取。在不使用框架时，你可以通过这种方式接入 General Translation；在 Flask 和 FastAPI 中，[`initialize_gt`](/docs/python/reference/functions/initialize-gt) 会为你调用它。

## 概览 [#overview]

调用 `set_i18n_manager`，并传入你构建的管理器。之后，[`t`](/docs/python/reference/functions/t)、区域设置辅助函数以及 [`get_i18n_manager`](/docs/python/reference/functions/get-i18n-manager) 都会使用它。

```python
from gt_i18n import I18nManager, set_i18n_manager

manager = I18nManager(default_locale="en", locales=["es", "fr"])
set_i18n_manager(manager)
```

签名：

```python
set_i18n_manager(manager: I18nManager) -> None
```

从 `gt_i18n` 导入 `set_i18n_manager`。框架包不会再次导出它。

## 工作原理 [#how-it-works]

* **单例赋值。**它会将管理器保存为模块级单例，并替换之前的实例。
* **框架中的用法。**`initialize_gt` 会在内部调用它；只有在不使用框架、直接使用 core library 时，你才需要直接调用它。

## 参数 [#parameters]

| 参数                    | 描述              | Type                                                         | 可选 | 默认值 |
| --------------------- | --------------- | ------------------------------------------------------------ | -- | --- |
| [`manager`](#manager) | 要注册为当前活动单例的管理器。 | [`I18nManager`](/docs/python/reference/classes/i18n-manager) | 否  | —   |

### `manager` [#manager]

**类型** [`I18nManager`](/docs/python/reference/classes/i18n-manager) · **必填**

待注册的管理器实例。

## 返回值 [#returns]

**类型** `None`

## 示例 [#example]

```python
from gt_i18n import I18nManager, set_i18n_manager, t

manager = I18nManager(default_locale="en", locales=["es"])
set_i18n_manager(manager)
manager.set_locale("es")
t("Hello, world!")
```