文本分割

函数名：wb_文本分割 / str_Split

功能描述

将文本按指定分隔符分割成多个部分，结果以垂直二维数组形式返回。可选择是否移除分割后产生的空项。

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

语法

=str_Split(文本, 分隔符, 移除空项)

参数

参数名	类型	必填	默认值	说明
文本	String	是	无	原始文本
分隔符	String	是	无	用于分割的分隔符
移除空项	Boolean	否	TRUE	TRUE=移除空项，FALSE=保留空项

返回值

Object - N 行 1 列的垂直二维数组，每个元素为分割后的文本片段。

使用示例

基本分割

公式：

=str_Split("苹果,香蕉,橙子", ",")

结果（垂直数组，溢出到多个单元格）：

苹果
香蕉
橙子

保留空项

公式：

=str_Split("A,,B,C", ",", FALSE)

结果（保留中间空项）：

A

B
C

移除空项

公式：

=str_Split("A,,B,C", ",", TRUE)

结果（移除中间空项）：

A
B
C

技术说明

• 内部调用 .NET 的 string.Split 方法，传入分隔符数组和 StringSplitOptions 选项
• 移除空项 为 TRUE 时使用 StringSplitOptions.RemoveEmptyEntries，为 FALSE 时使用 StringSplitOptions.None
• 返回结果为 object[,] 类型的二维数组（N 行 1 列），Excel 中会自动溢出为垂直多单元格区域
• 分隔符区分大小写，按精确匹配进行分割

错误处理

错误场景	返回值
原文本为空或 null	#N/A（ExcelError.ExcelErrorNA）
分隔符未在文本中找到	整个文本作为单个元素的数组
处理过程中发生异常	#VALUE!（ExcelError.ExcelErrorValue）