灵析表格

Appearance

str_RandomGivenName函数 ​

函数名：wb_取随机名字 / str_RandomGivenName

函数功能 ​

随机生成一个中文名字，可指定名字字数（1或2个字）及性别（男/女）。适用于姓名模拟、测试数据生成等场景，参数可选，支持默认随机。

参数规范 ​

参数名类型必填示例特殊说明
nameCountInt否1、2控制名字的字数，默认随机1或2字
genderInt否1（男）、2（女）性别参数，0为随机

使用案例 ​

· 随机生成姓名（默认1-2字，随机性别） ​

问题描述：无需设定参数，生成任意性别的随机名字 公式演示：

excel
=str_RandomGivenName()

输出效果（示例）：

text
伟

· 生成2字男孩名字 ​

问题描述：指定生成一个2个字的男性名字 公式演示：

excel
=str_RandomGivenName(2, 1)

输出效果（示例）：

text
志强

· 生成1字女孩名字 ​

问题描述：生成一个1字的女性名字 公式演示：

excel
=str_RandomGivenName(1, 2)

输出效果（示例）：

text
芬

技术说明 ​

· 名字生成逻辑 ​

  • 字库来源：内置高频中文姓名字典，分别按性别划分

  • 名字长度控制：nameCount 控制生成字数，超出2则自动限制为2

  • 性别判断逻辑：

    • gender=0 时从男/女随机
    • gender=1 男名字库
    • gender=2 女名字库

· 随机机制 ​

使用 _random.Next(0, namePool.Length) 生成索引，从指定名字字库中抽取汉字拼接生成。

异常处理 ​

错误场景返回值
参数超出定义范围自动限制在合法范围内（长度最大2，性别默认随机）
字库访问异常返回空字符串或部分结果（极少发生）

扩展应用 ​

· 与姓氏函数联合使用 ​

excel
=str_RandomSurname() & str_RandomGivenName(2, 1)

输出效果（示例）：

text
王志强

· 大批量生成姓名列表 ​

在多个单元格内拖动复制公式，即可快速生成不同姓名，用于模拟数据或表单测试。

注：本函数在WPS 2019+和Excel 365中测试通过，适用于所有支持VSTO插件的环境。