Symbol.toPrimitive 是用于自定义对象类型转换行为的方法，当参与加法等运算时优先于 toString() 和 valueOf() 被调用；默认返回 "[object Object]" 是因回退到 toString()；通过在 hint 为 "string"、"number" 或 "default" 时返回对应原始值可精准控制转换结果。

Symbol.toPrimitive 是 JavaScript 中用于自定义对象在类型转换（如转为字符串、数字或默认值）时行为的特殊符号方法。当对象参与加法运算（+）时，若其中一个操作数是原始类型（如字符串或数字），JavaScript 会尝试将另一个操作数转为原始值——这时就会调用 Symbol.toPrimitive（如果存在），而不是依赖 toString() 或 valueOf() 的默认顺序。

为什么会出现 "[object Object]"？

默认情况下，对象在字符串拼接中会调用 toString()，返回 "[object Object]"。例如：

const obj = {};<br>console.log('hello' + obj); // "hello[object Object]"

这是因为加法运算中，当一侧是字符串，JS 会把另一侧强制转为字符串，而普通对象没有自定义的 Symbol.toPrimitive，于是回退到 toString()。

如何用 Symbol.toPrimitive 控制转换结果？

在对象上定义 [Symbol.toPrimitive](hint) 方法，根据 hint 参数（"string"、"number" 或 "default"）返回合适的原始值：

• hint === "string"：用于字符串拼接（如 'a' + obj）
• hint === "number"：用于算术运算（如 obj + 1，且左侧不是字符串）
• hint === "default"：当 JS 不明确期望类型时（如 obj + '' 或 obj == 123），多数引擎会先试 "default"，再 fallback 到 "number" 或 "string"

示例：

const person = {<br>  name: 'Alice',<br>  age: 30,<br>  [Symbol.toPrimitive](hint) {<br>    if (hint === 'string') return this.name;<br>    if (hint === 'number') return this.age;<br>    return this.name; // default → 通常按 string 处理<br>  }<br>};<br><br>console.log('Hello, ' + person); // "Hello, Alice"<br>console.log(person + 5);         // "Alice5"（因为 + 左侧是对象，右侧是数字 → hint="default" → 返回 name → 字符串拼接）<br>console.log(person * 2);         // 60（* 触发 hint="number"）

加法运算中 hint 的实际触发逻辑

加法运算 a + b 的原始值提取规则是：

• 如果 a 或 b 是字符串 → 整个表达式按字符串拼接处理 → 对非字符串操作数调用 toPrimitive(hint="string")
• 否则（两个都是非字符串原始值或对象）→ 尝试转为数字 → 调用 toPrimitive(hint="number")
• 但注意：obj + ''、obj + '0' 这类明显偏向字符串的场景，引擎会直接用 hint="string"

所以，要避免 [object Object]，关键是在 hint === "string" 分支返回有意义的字符串，而非依赖默认 toString()。

实用建议

• 始终在 hint === "string" 时返回清晰、无歧义的字符串（如 ID、名称、描述）
• 不要在 toPrimitive 中抛错或返回对象；必须返回原始值（string/number/boolean/null/undefined），否则会报 TypeError
• 若对象逻辑上“不可转为字符串”，可返回空字符串或占位符（如 ''），比 [object Object] 更可控
• 调试时可用 console.log(obj[Symbol.toPrimitive]('string')) 直接测试输出