JSON.parse()和JSON.stringify()仅做字符串与对象转换,字段名转换需手动实现;解析报错常因单引号、尾逗号或HTML响应;下划线与驼峰互转需递归处理嵌套结构;日期、undefined、BigInt等类型需特殊处理。

JavaScript 中 JSON.parse() 和 JSON.stringify() 就是干这个的,没别的花招。但实际用的时候,下划线命名(user_name)和驼峰(userName)来回转,得自己写逻辑——JSON 标准本身不处理字段名转换。
JSON.parse() 会报错?先检查这三件事
常见错误不是语法问题,而是你忽略了数据来源的“脏”:
-
JSON.parse()只接受严格格式的字符串:双引号、不能有尾逗号、不能有注释 -
后端返回的是
"{user_name: 'foo'}"(单引号)?直接报SyntaxError: Unexpected token u in JSON at position 1 - 接口返回的是 HTML 页面(比如 500 错误页),但你没检查
response.headers.get('content-type'),就直接parse,结果解析的是"..."
稳妥做法:
try {
const data = JSON.parse(responseText);
} catch (e) {
console.error('JSON 解析失败,原始内容:', responseText.slice(0, 200));
throw e;
}
下划线转驼峰:别在 parse 里硬改,用 transform 函数
JSON.parse() 不支持中间处理字段名,所以得在解析完再递归遍历对象。注意:不能只改第一层,嵌套对象、数组里的对象都要进。
立即学习“Java免费学习笔记(深入)”;
一个轻量可靠的转换函数:
function snakeToCamel(obj) {
if (obj === null || typeof obj !== 'object') return obj;
if (Array.isArray(obj)) {
return obj.map(snakeToCamel);
}
const result = {};
for (const [key, value] of Object.entries(obj)) {
const camelKey = key.replace(/_([a-z])/g, (_, g) => g.toUpperCase());
result[camelKey] = snakeToCamel(value);
}
return result;
}
// 用法
const raw = '{"user_name":"alice","profile":{"first_name":"Alice","last_name":"Smith"}}';
const parsed = JSON.parse(raw); // { user_name: "...", profile: {...} }
const camelized = snakeToCamel(parsed); // { userName: "...", profile: { firstName: "...", lastName: "..." } }
驼峰转下划线:stringify 前处理,但要注意循环引用
JSON.stringify() 的第二个参数 replacer 可以拦截键值对,但它只传入 key 和 value,不提供父级上下文,所以无法区分“顶层 userName”和“嵌套里的 userName”。更稳的方式仍是先 transform 再 stringify。
示例(带简单循环引用防护):
function camelToSnake(obj, seen = new WeakMap()) {
if (obj === null || typeof obj !== 'object') return obj;
if (seen.has(obj)) return seen.get(obj);
if (Array.isArray(obj)) {
const arrCopy = [];
seen.set(obj, arrCopy);
return obj.map(item => camelToSnake(item, seen));
}
const result = {};
seen.set(obj, result);
for (const [key, value] of Object.entries(obj)) {
const snakeKey = key.replace(/([A-Z])/g, '_$1').toLowerCase();
result[snakeKey] = camelToSnake(value, seen);
}
return result;
}
// 用法
const payload = { userName: 'bob', profile: { firstName: 'Bob' } };
const snakePayload = camelToSnake(payload);
const jsonStr = JSON.stringify(snakePayload); // {"user_name":"bob","profile":{"first_name":"Bob"}}
真正容易被忽略的点
一是日期字段:JSON 没有原生 date 类型,new Date().toJSON() 输出的是 ISO 字符串,JSON.parse() 后还是字符串,不会自动变回 Date 对象;二是 undefined、function、Symbol 在 stringify 时会被静默丢弃;三是 BigInt 直接报错,必须手动处理。
这些都不是下划线/驼峰的问题,但和 JSON 转换常一起出现,一并踩坑。











