Symbol 到字符串的强制转换错误
快速摘要
你用 + 把 Symbol 与字符串拼接,或在模板字符串中使用它却没调用 String()——JavaScript 抛错,因为 Symbol 不能隐式转换。
为什么发生
使用
symbol + ''或模板字符串却未显式调用 String()在期望字符串的地方传入 Symbol 却未显式转换
对象属性访问中把 Symbol 键与字符串操作混用
最小示例
✗ 错误代码
const id = Symbol('user');
console.log('id: ' + id); // TypeError: Cannot convert a Symbol value to a string✓ 修复代码
const id = Symbol('user');
console.log('id: ' + id.description); // 'id: user'+ 运算符试图把 Symbol 隐式转为字符串,这是被禁止的。使用 .description 取出描述字符串后即可正常拼接。
如何诊断
阅读 TypeError: 'Cannot convert a Symbol value to a string/number'
用 typeof 检查 + 和模板字符串的操作数
查找流入字符串构建代码的 Symbol() 值
如何修复
显式调用 String(symbol) 或 symbol.description 进行转换
用 symbol.description 获取描述字符串部分
避免对 Symbol 做算术——确需数字时先显式转换
如何预防
绝不用 + 拼接 Symbol——始终显式转换
当 Symbol 可能出现时,在字符串操作前做类型检查