TypeError: x.replace 不是函数
快速摘要
你对数字、数组或对象调用了 .replace(或 .trim、.split)——这些方法只存在于字符串上。
为什么发生
本应是字符串的变量实际是数字或数组
JSON.parse 返回了数字而预期是字符串
函数参数在调用字符串方法前未做类型校验
最小示例
✗ 错误代码
const id = 12345;
console.log(id.replace('1', 'x')); // TypeError: id.replace is not a function✓ 修复代码
const id = 12345;
console.log(String(id).replace('1', 'x')); // 'x2345'id 是数字,没有 .replace 方法。先用 String(id) 转换即可安全调用字符串方法。
如何诊断
阅读 TypeError: 'x.replace is not a function'
在调用前用 typeof x 和实际值打日志
追溯值的来源以定位类型不匹配
如何修复
调用前先用 String(x) 把值转为字符串
修正源头使其按预期产出字符串
在调用字符串专属方法前加类型判断分支
如何预防
在函数边界处校验类型
用 TypeScript 在编译期捕获类型不匹配