JavaScript中，toString优先用于字符串转换，valueOf优先用于数值转换；二者须返回原始值，且避免互相调用；Symbol.toPrimitive会覆盖它们。
在 JavaScript 中，valueOf 和 toString 是两个可以被引擎自动调用的“隐式转换钩子”，用于将对象转为原始值（如数字、字符串）。它们的触发时机不同，配合使用能精准控制对象在各种上下文中的表现。
什么时候调用 toString？
当 JavaScript 需要将对象转为字符串时（比如拼接字符串、String(obj)、alert(obj)），会优先尝试调用 toString()。如果返回的是原始值（字符串、数字等），就直接使用；否则再尝试 valueOf()，最后才报错。
- 字符串拼接：
"hello " + obj→ 先查obj.toString() -
String(obj)→ 固定走toString()（不查valueOf） - 注意：如果
toString()返回的不是字符串（比如返回数字），也不会报错，但结果可能不符合预期
什么时候调用 valueOf？
当需要数值运算或显式转数字时（比如 +obj、obj * 2、Number(obj)），引擎会优先调用 valueOf()。若它返回原始值，就直接用；否则回退到 toString()，再不行就报 TypeError。
- 算术运算：
obj + 1、obj * 3→ 先查obj.valueOf() -
Number(obj)→ 固定走valueOf()（再 fallback 到toString()） - 比较操作如
obj == 42也会触发valueOf()（宽松相等会尝试转换）
如何安全地自定义这两个方法？
关键原则是：两个方法都必须返回原始值（string/number/boolean/null/undefined），否则可能引发意外行为或无限递归。推荐写法：
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
立即学习“Java免费学习笔记（深入）”；
-
toString()总是返回字符串（哪怕只是"[object Custom]"） -
valueOf()总是返回有意义的数字（或布尔、字符串），且类型与业务语义一致 - 避免互相调用，防止栈溢出（比如
toString里又调valueOf，而valueOf又调toString）
示例：
class Money {
constructor(amount) {
this.amount = amount;
}
toString() {
return `$${this.amount.toFixed(2)}`;
}
valueOf() {
return this.amount; // 原始 number，支持加减乘除
}
}
const price = new Money(99.99);
console.log(price + 0.01); // 100 → 走 valueOf()
console.log("Cost: " + price); // "Cost: $99.99" → 走 toString()
console.log(Number(price)); // 99.99 → 走 valueOf()
要注意的坑
ES6+ 中 Symbol.toPrimitive 会覆盖两者，成为更高优先级的转换入口。如果同时定义了 [Symbol.toPrimitive]()，它会在所有隐式转换中被优先调用，valueOf 和 toString 就不会执行。
- 调试时可用
console.dir(obj)查看是否被拦截 - 框架或库（如 moment.js 旧版）曾重度依赖这两个方法，现代代码建议优先用
Symbol.toPrimitive显式控制 - 不要在
valueOf或toString中抛错或返回对象——这会让转换失败，影响整个表达式
