文本连接

函数名：wb_文本连接 / str_Concat

功能描述

将多个文本或数组中的文本连接在一起，使用指定分隔符分隔各元素。支持可变参数输入，可混合传入单值和数组，空单元格（ExcelEmpty）自动转为空字符串。

会员等级：🟢 免费版（Free）

语法

=str_Concat(分隔符, 文本1, ...)

参数

参数名	类型	必填	默认值	说明
分隔符	String	是	无	连接时使用的分隔符
文本1	Object	是	无	第一个文本或数组
...	Object[]	否	无	更多文本或数组（可变参数，支持任意数量）

返回值

String - 所有文本用分隔符连接后的结果字符串。

使用示例

连接多个文本

公式：

=str_Concat("-", "A", "B", "C")

结果：

A-B-C

连接数组元素

公式：

=str_Concat(",", A1:A3)

结果（当 A1="张三"、A2="李四"、A3="王五"）：

张三,李四,王五

混合单值与数组

公式：

=str_Concat("|", "开头", A1:A2, "结尾")

结果（当 A1="X"、A2="Y"）：

开头|X|Y|结尾

技术说明

• 使用 params object[] 可变参数机制，支持传入任意数量的文本或数组
• 内部使用 StringBuilder 高效拼接，将第一个参数（文本1）与后续参数（moreObjects）合并到统一列表中处理
• 数组展开：检测到 Array 类型参数时，自动遍历数组中的每个元素逐一连接
• 空值处理：显式处理 ExcelDna.Integration.ExcelEmpty 类型（即 Excel 中的空单元格），将其转为空字符串而非 "ExcelEmpty" 字面量；null 元素同样转为空字符串
• 第一个元素之后每次连接前插入分隔符，确保首元素前不出现多余分隔符

错误处理

错误场景	返回值
数组中含空单元格（ExcelEmpty）	空字符串（正常连接，不影响其他元素）
元素为 null	空字符串
处理过程中发生异常	"错误: {异常信息}"