JavaScript类型转换时，引擎按hint严格调用valueOf和toString：数字hint先valueof后toString，字符串hint先toString后valueOf，default hint多数按number处理（Date例外）；两方法均须返回原始值，否则跳过，全失败则抛TypeError。
对象在类型转换时，valueOf 和 toString 不是随意调用的，而是由 JavaScript 引擎根据转换目标类型（即 toPrimitive 的 hint）严格按顺序尝试。
调用顺序取决于“期望得到什么类型”
引擎不会同时查两个方法，也不会随机选一个。它先看当前上下文需要哪种原始值：
- 需要 数字（如
+obj、obj == 5、Number(obj)）→ 先调obj.valueOf()；若返回原始值（number/string/boolean等），直接使用；若返回对象（如{}或数组），再试obj.toString() - 需要 字符串（如
"x" + obj、String(obj)、alert(obj)）→ 先调obj.toString()；若返回字符串，就用它；若返回非字符串原始值（比如数字123），或对象，则继续调valueOf()尝试 - 需要 默认类型（如
obj == "123"、obj + ""）→ 多数引擎（如 V8）按"number"hint 处理，即先valueOf()；但Date是例外，它对default优先用toString()
返回值必须是原始值，否则会被跳过
这两个方法都必须返回原始值（string / number / boolean / symbol / null / undefined），否则该次调用视为失败：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
-
valueOf()返回一个对象（例如return this或[]）→ 引擎立刻忽略，转而尝试toString() -
toString()返回数字42（不是字符串"42"）→ 不算有效字符串结果，若还有 fallback 机会，会继续调valueOf() - 两者都返回对象 → 抛出
TypeError: Cannot convert object to primitive value
常见内置对象的行为差异
不同对象对这两个方法的实现直接影响转换结果：
立即学习“Java免费学习笔记（深入）”；
-
Date：重写了valueOf()返回时间戳（number），toString()返回可读日期（string）。所以+new Date()得数字，"" + new Date()得字符串 -
Array：重写了toString()为.join(",")，所以[1,2] + ""→"1,2"；但valueOf()没重写，仍返回数组本身（对象），不参与数值运算 - 普通对象（
{}）：两个方法都返回对象自身或"[object Object]"，因此在数学运算中常得NaN（valueOf()→ 对象 → 忽略 →toString()→ 字符串 → 转数字失败）
自定义类时的关键原则
重写这两个方法，重点不是“想输出什么”，而是匹配调用场景的语义需求：
- 让对象支持加减乘除 →
valueOf()应返回有意义的 number（如金额类返回数值） - 让
console.log()或拼接显示友好格式 →toString()应返回清晰的 string（如"User{id: 123, name: 'Alice'}"） - 避免
toString()返回数字、valueOf()返回字符串——这会让引擎无法按预期路径处理，可能绕过你设计的逻辑
