Symbol.split 是为分隔符对象设计的，定义其作为 string.split() 参数时的分割行为；被分割目标只能是字符串，且 Symbol.split 必须部署在对象上而非原始值。
Symbol.split 不是用来处理“复杂原始类型”的——JavaScript 中没有“复杂原始类型”这个概念。原始类型（如 string、number、boolean、symbol 等）本身不可变、无方法、不能自定义行为；而能定义 [Symbol.split] 的，必须是**对象**（哪怕是个轻量包装对象），因为只有对象才能拥有可配置的 Symbol 方法。
Symbol.split 的作用对象是分隔符，不是被分割的字符串
很多人误以为 Symbol.split 是给某个“自定义数据类型”加分割能力，其实它定义的是：当这个对象**作为 split() 的参数（即分隔符）时，如何参与分割过程**。被分割的始终是字符串（string.split(separator)），而 separator 可以是一个带 [Symbol.split] 方法的对象。
关键点：
- 被分割目标只能是字符串（原始值），它本身无法挂载
[Symbol.split] - 你定义的
[Symbol.split]必须写在**分隔符对象**上，且该函数接收被分割字符串作为参数 - 该函数需返回一个数组（分割结果），或按规范返回等效结构（如类数组）
实现自定义分割逻辑的三步写法
以“按首次出现的关键词截断并保留分隔符前缀”为例（如 'hello-world'.split(new PrefixSplitter('world')) → ['hello-', 'world']）：
1. 创建一个构造函数或类，封装分隔逻辑所需的参数（如关键词、是否保留、是否忽略大小写等）
2. 在原型或实例上定义 [Symbol.split](str) 方法，内部执行你的算法
3. 确保返回值是数组（或具有 length 和数字索引的类数组）
示例代码：
class PrefixSplitter {constructor(keyword) {
this.keyword = keyword;
}
[Symbol.split](str) {
const idx = str.indexOf(this.keyword);
if (idx === -1) return [str];
return [
str.slice(0, idx + this.keyword.length),
str.slice(idx + this.keyword.length)
];
}
}
console.log('abc-xyz-def'.split(new PrefixSplitter('xyz')));
// → ['abc-xyz', '-def']
常见误区与注意事项
• 不能直接给原始值加 Symbol.split：比如 String.prototype[Symbol.split] = ... 是无效的，且违反规范；Symbol.split 是为分隔符设计的，不是扩展字符串本身
• 返回值必须是数组语义：即使返回 {0: 'a', 1: 'b', length: 2} 也能被识别，但建议直接返回数组，避免隐式转换风险
• 不支持异步或副作用逻辑：该方法应在同步、纯计算模式下完成；若需异步预处理（如查表、网络请求），需提前完成并缓存结果
• 兼容性注意：所有现代浏览器及 Node.js ≥ 4 都支持，但旧版 IE 完全不支持 Symbol，不可用于需要降级的场景
何时该用 Symbol.split，何时该换方案
适合用 Symbol.split 的情况：
- 需要复用同一套分割逻辑，在多个地方以不同分隔符对象形式传入
.split() - 分隔行为依赖运行时状态（如用户配置、上下文标记），且希望保持 API 一致（仍走原生
split调用） - 构建 DSL 工具链，例如日志解析器中把“时间戳模式对象”直接当 separator 用
更适合换方案的情况：
- 要对非字符串数据（如 ArrayBuffer、TypedArray、自定义类实例）做“类分割”操作 → 应定义自己的
.sliceBy(...)方法 - 分割规则基于正则模式（含捕获组、前瞻后顾）→ 直接用
str.match(/.../g)或str.split(/.../) - 需流式处理超长文本或内存敏感 →
Symbol.split会一次性生成全部子串，此时应手写迭代器或使用String.prototype.matchAll
