# 适用于 Microsoft Excel 的 GenderAPI 公式

> 在 Excel 中使用 GENDER.FROM_NAME、GENDER.FROM_EMAIL 和 GENDER.FROM_USERNAME。了解参数、默认值、扩展输出和常见错误。

Canonical HTML: https://www.genderapi.io/zh/blog/gender-formula-for-microsoft-excel

Last reviewed: 2026-09-29

## 选择与输入相匹配的函数

安装 GenderAPI Excel 插件，在其侧边栏中保存您的 API 密钥，然后对姓名使用 GENDER.FROM_NAME，对电子邮箱地址使用 GENDER.FROM_EMAIL，对用户名使用 GENDER.FROM_USERNAME。每个函数先接收输入，然后是一个可选的额外信息开关，最后是可选的国家/地区背景。

这些 Excel 公式基于旧版 API。Google Sheets 的 GENDER 公式有不同的签名，而直接调用的 V2 REST API 有自己的 JSON 契约。

- [安装 Excel 插件](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [在 Excel 中配置侧边栏](https://www.genderapi.io/zh/blog/genderize-excel-names-using-genderapi-excel-add-in)

## 三个参数，顺序固定

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `name / email / username` | 文本或单元格引用 | 必填 | 所选函数的输入，例如 A2。 |
| `enable_additional_info` | 布尔值 | FALSE | TRUE 或 1 会返回四列。省略该参数或使用 FALSE/0 时只返回性别。 |
| `country` | 文本 | 不按国家/地区筛选 | 可选的两位字母国家/地区代码，例如 IT、US、DE 或 TR。如果提供了第三个参数，也必须提供第二个参数。 |

**Excel 公式示例**

每一行都是一个独立的示例。请在 A2 中输入相应的姓名、电子邮箱地址或用户名。根据 Excel 的区域设置，参数分隔符可能是分号而不是逗号。

```text
=GENDER.FROM_NAME(A2)
=GENDER.FROM_NAME(A2, TRUE, "IT")
=GENDER.FROM_EMAIL(A2, TRUE)
=GENDER.FROM_USERNAME(A2, FALSE)
```

## Excel 中的扩展输出占用四列

不启用额外信息时，公式只返回性别。启用后，Excel 文档中说明的输出会在一行中依次填入性别、probability、国家/地区和识别出的名字。请让右侧的三个单元格保持为空。

Google Sheets 公式会把国家/地区放在 probability 之前，因此在核实 Excel 中适用的顺序之前，不要直接复用那里的列标题。

| 位置 | Excel 输出 | 含义 |
| --- | --- | --- |
| 1 | Gender | 识别出的性别或未解析的值。请单独处理运行错误。 |
| 2 | Probability | 旧版 API 的置信度信号；它不是 V2 的 confidence_kind，也不是实测的模型准确率。 |
| 3 | Country | 查询返回的国家/地区背景，而不是当事人经过核实的属性。 |
| 4 | Matched name | 请检查使用或提取出的名字，尤其是对于电子邮箱地址和用户名。 |

## 向下复制公式之前先修正配置错误

重新计算可能会触发一次新的查询。如果您需要一个稳定的快照，请把已得到的结果以值的形式粘贴，并在旁边保存原始数据和核对日期。

| 症状 | 检查内容 |
| --- | --- |
| 函数不可用 | 确认插件已安装，并且在此工作簿和此 Excel 环境中可用。 |
| 未提供 API 密钥 | 打开 GenderAPI 侧边栏并保存密钥。写在单元格中的密钥不能代替插件中保存的凭据。 |
| 输入为空 | 检查公式引用的单元格，并选择与实际输入类型相匹配的函数。 |
| 没有出现扩展输出 | 腾出所需的相邻目标单元格，但不要覆盖有用的数据。 |
| 错误信息或 unknown error | 检查连接、账户状态和返回的信息。运行错误并不是未解析的预测。 |

## 规划积分、限制和重新运行

已注册的免费 GenderAPI 账户每天包含 200 个积分。这是账户余额，并不承诺每个工作流都能得到 200 个已识别的结果。开始之前，请检查所选密钥的余额以及该工具当前的处理选项。

插件和文件处理遵循各自的处理流程。V2 REST API 的批量限制、AI 选项和每个请求的计费字段并不会自动适用于这些工具。重新运行或重新计算可能会发送新的请求并消耗积分，因此不要默认它是免费的。

请先从小样本开始，保存已得到的结果，并在重新运行之前复核失败的行。如果您只需要修正一次导出或目标系统中的更新，请复用已有的结果。

- [账户方案与积分](https://www.genderapi.io/zh/price)

## 何时直接使用 V2 API

如果您的应用需要明确的 AI 选项，并需要每个条目的 V2 status、source、confidence_kind 和 usage 信息，请配置单独的 HTTP 集成。请遵循 V2 的请求和响应契约：把 V2 字段名添加到插件自带的公式或现有插件中，并不会改变它们的行为。

- [请求参数](https://www.genderapi.io/zh/docs/v2/request-parameters)
- [V2 响应字段](https://www.genderapi.io/zh/docs/v2/responses)
- [使用 Python 进行 V2 集成](https://www.genderapi.io/zh/integrations/python)
- [使用 Node.js 进行 V2 集成](https://www.genderapi.io/zh/integrations/javascript)

## 可以在 Microsoft Excel 中使用 =GENDER(A2) 吗？

Excel 插件文档中说明的函数是 GENDER.FROM_NAME、GENDER.FROM_EMAIL 和 GENDER.FROM_USERNAME。简单的 GENDER 公式属于 Google Sheets 插件。

## 如何在不返回额外输出的情况下提供国家/地区？

请保持第二个参数为关闭状态，例如 =GENDER.FROM_NAME(A2, FALSE, "IT")。国家/地区是第三个参数，而不是第二个。

## 额外信息选项的默认值是什么？

省略该参数时，它处于关闭状态。TRUE 或 1 会启用四列输出：性别、probability、国家/地区和识别出的名字。

## 这些函数会返回 V2 的计费信息吗？

不会。内置公式显示的是旧版 API 的结果字段。如果您需要请求元数据、source、confidence_kind 或每个请求的用量，请使用单独的 V2 集成。

## 来源与文档

- [Microsoft AppSource 上的插件官方页面](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [Excel 公式文档：gender_from_name](https://excel.genderapi.io/help/gender_from_name.html)
- [Excel 公式文档：gender_from_email](https://excel.genderapi.io/help/gender_from_email.html)
- [Excel 公式文档：gender_from_username](https://excel.genderapi.io/help/gender_from_username.html)
- [已发布的 Excel 函数定义](https://excel.genderapi.io/functions_v2.json)
- [GenderAPI 方案与积分](https://www.genderapi.io/zh/price)
- [GenderAPI 隐私政策](https://www.genderapi.io/zh/privacy-policy)
- [V2 请求契约](https://www.genderapi.io/zh/docs/v2/request-parameters)