str_RandomSurname函数

函数名：wb_取随机姓氏 / str_RandomSurname

函数功能

从内置的常见中文姓氏库中随机返回一个汉字姓氏，适用于数据生成、测试填充或姓名模拟等应用场景。

参数规范

本函数无输入参数，调用时直接执行，无需传参。

使用案例

· 随机生成姓氏用于模拟数据

问题描述：在用户注册测试中，需要批量生成随机的中文姓氏。 公式演示：

=str_RandomSurname()

输出效果（示例）：

张

· 批量生成多个姓氏

问题描述：结合Excel拖动功能生成多个随机姓氏，适用于样本测试。 公式演示：

=str_RandomSurname()

操作说明：在下拉填充单元格时，每一行会返回不同的姓氏。

技术说明

· 姓氏库内容

内置的中文姓氏字符集合共包含多个高频姓氏，覆盖常见姓氏，包括但不限于“赵、钱、孙、李、周、吴、郑、王”等。

· 随机逻辑说明

• 使用 _random.Next(0, _surnames.Length) 随机生成下标
• 使用 Substring(index, 1) 提取对应位置的姓氏字符

· 默认容错机制

• 如遇异常（如索引越界），返回默认姓氏 "李"，确保函数稳定性

异常处理

错误场景	返回值
随机索引异常	"李"
其他未知异常	"李"

扩展应用

· 结合名字生成函数

可与其他名字生成函数配合，构建完整中文姓名：

= str_RandomSurname() & str_RandomGivenName()

· 测试数据批量模拟

用于生成用户测试数据、表单填充等场景，提升效率与多样性。

注：本函数在WPS 2019+ 和 Excel 365 中测试通过，兼容性良好。