str_Concat函数

函数名：wb_文本连接 / str_Concat

函数功能

将多个文本按照指定分隔符连接成一个整体字符串，支持变长参数，适用于拼接多列内容、格式化输出等场景。

参数规范

参数名	类型	必填	示例	特殊说明
delimiter	String	是	"-"	各文本之间的连接符，如空格、逗号
text1	String	是	"张"	第一个要连接的文本
text2	String	是	"三"	第二个要连接的文本
...	Object[]	否	"工程师"等	可变数量的更多文本

使用案例

· 基础拼接示例

问题描述：将多个词组合为一句话，词间以空格隔开 公式演示：

=str_Concat(" ", "你好", "世界", "！")

输出效果：

你好 世界 ！

· 使用分隔符拼接多列值

问题描述：用“|”连接多个单元格的值 公式演示：

=str_Concat("|", A1, B1, C1)

输出效果（当A1="张", B1="三", C1="工程师"）：

张|三|工程师

· 无分隔符拼接

问题描述：直接将多段内容无缝拼接 公式演示：

=str_Concat("", "2025", "年", "07", "月")

输出效果：

2025年07月

技术说明

• 基于 StringBuilder 构建连接字符串，性能优于字符串直接相加
• params object[] 支持传入多个文本参数（不限数量）
• 参数内部使用 ToString() 转换，支持数字等非字符串类型

异常处理

错误场景	返回值
参数为 null	自动转换为空字符串
函数运行异常	错误: [异常信息]

扩展应用

· 组合地址、标签、代码等结构化文本

=str_Concat("-", A2, B2, C2)

输出示例：

上海-浦东-张江

· 条件拼接（配合IF函数）

=IF(D2="是", str_Concat(",", A2, B2, C2), A2)

注：本函数在WPS 2019+和Excel 365中测试通过，支持文本与数值混合拼接。