在 TypeScript 项目里调用 `JSON.parse(localStorage.getItem('user') ?? '{}')` 之后，多数人下意识会直接访问 `user.name`、`user.email`，编辑器既不报错也不提示，直到线上运行时因为某个字段缺失或者类型不对炸掉。问题根源是 `JSON.parse` 的签名返回 `any`，它把类型检查整个绕过去了，而 `any` 又会沿着属性访问、函数传参悄悄污染下去。这篇文章从 lib.es5.d.ts 里的定义讲起，说清楚为什么标准库不把它改成 `unknown`，以及在实际业务里怎么用运行时校验、类型守卫和第三方 schema 库把这块缺口补上，让解析出来的数据真正受控，而不是靠 `as User` 硬断言的自我安慰。

先看 TypeScript 标准库里 `JSON.parse` 的签名：

```ts
// lib.es5.d.ts
parse(text: string, reviver?: (this: any, key: string, value: any) => any): any;
```

返回 `any` 是历史包袱。早期大量 JS 代码迁移到 TS 时，如果这里返回 `unknown`，所有现有代码都得先断言再使用，迁移成本会非常高，所以标准库一直没动它。`any` 的麻烦在于它是双向逃逸的：你可以把任意值赋给它，也可以把它赋给任意类型，类型系统在这条链路上基本失效。

```ts
const raw = localStorage.getItem('user');
const user = JSON.parse(raw ?? '{}');

// 编译期完全通过，运行期 user.profile 可能是 undefined
console.log(user.profile.avatar);
```

真正危险的不是解析那一行，而是 `any` 会往下传染。把 `user` 传进一个接收 `User` 的函数，编译器不会拦你；从 `user` 上取一个字段再塞进接口请求体，也不会拦你。等到接口返回 400 才发现发出去的是 `undefined`。

比较直接的做法是在解析入口处把 `any` 收窄成 `unknown`，然后显式做校验。TypeScript 允许给 `JSON.parse` 的结果做一次 `unknown` 标注，这不会改变运行时行为，只是把后续访问强制纳入检查：

```ts
function parseJson(text: string): unknown {
 return JSON.parse(text);
}

const data = parseJson(raw ?? '{}');
// data.name 会直接报错，因为 unknown 上不能随便取属性
```

接下来需要一个类型守卫。手写校验函数适合字段少、结构稳定的场景：

```ts
interface User {
 id: number;
 name: string;
 email: string;
}

function isUser(value: unknown): value is User {
 if (typeof value !== 'object' || value === null) return false;
 const v = value as Record<string, unknown>;
 return (
 typeof v.id === 'number' &&
 typeof v.name === 'string' &&
 typeof v.email === 'string'
 );
}

const data = parseJson(raw ?? '{}');
if (isUser(data)) {
 // 这里 data 是 User，可以安全访问
 sendWelcomeEmail(data.email);
} else {
 // 处理损坏的缓存，比如清掉重新登录
 localStorage.removeItem('user');
}
```

字段一多，手写守卫的维护成本就上来了，而且容易漏掉嵌套结构。用 zod 这类 schema 库能把校验和类型推导一起解决：

```ts
import { z } from 'zod';

const UserSchema = z.object({
 id: z.number(),
 name: z.string(),
 email: z.string().email(),
 profile: z
 .object({
 avatar: z.string().url(),
 })
 .optional(),
});

type User = z.infer<typeof UserSchema>;

function parseUser(text: string): User | null {
 const result = UserSchema.safeParse(JSON.parse(text));
 return result.success ? result.data : null;
}

const user = parseUser(raw ?? '{}');
if (user) {
 // user 已经是完整类型，profile 也做了可选处理
 console.log(user.profile?.avatar);
}
```

`safeParse` 不会抛异常，失败时返回 `{ success: false, error }`，适合缓存、localStorage、URL 参数这类不可信来源。接口请求如果本身有 OpenAPI 或后端 codegen，也可以直接用生成的类型配合运行时校验，避免前后端类型漂移。

另一个经常被忽略的点是 `reviver` 参数。`JSON.parse` 的第二个参数可以拦截每个键值，但它的 `this` 和 `value` 都是 `any`，写起来依然要自己保证类型：

```ts
const parsed = JSON.parse(json, (key, value) => {
 if (key === 'createdAt' && typeof value === 'string') {
 return new Date(value);
 }
 return value;
});
```

如果多个模块都用同一套 reviver，最好把它抽成共用函数并给它一个明确的返回类型，而不是让调用方各自处理。

对于确实信任的数据源，比如自己序列化后立刻反序列化的场景，`as` 断言不是不能用，但要把断言集中在一处，别散落在各个业务函数里。一个常见的折中是写一个带默认值的封装：

```ts
function parseWithFallback<T>(text: string | null, fallback: T): T {
 if (!text) return fallback;
 try {
 return JSON.parse(text) as T;
 } catch {
 return fallback;
 }
}
```

这个函数把 `as T` 收在内部，同时也处理了 `JSON.parse` 对非法 JSON 抛 `SyntaxError` 的情况——缓存被写坏时这是会真实发生的。调用方拿到的是确定的类型，风险被限制在一个小函数里，而不是整个应用都在裸奔 `any`。

实际项目里我更倾向于混合策略：入口统一用 `unknown`，可信的内部数据用带 fallback 的封装，跨边界的数据（缓存、URL、postMessage、第三方脚本）一律走 schema 校验。`any` 本身不是洪水猛兽，问题是它太容易在没人注意的情况下扩散，等到出问题时调用栈已经离解析点很远了。

 推荐查看成语：https://www.tianqi556.com/chengyu/14301.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14302.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14303.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14304.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14305.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14306.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14307.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14308.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14309.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14310.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14311.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14312.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14313.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14314.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14315.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14316.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14317.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14318.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14319.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14320.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14321.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14322.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14323.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14324.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14325.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14326.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14327.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14328.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14329.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14330.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14331.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14332.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14333.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14334.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14335.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14336.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14337.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14338.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14339.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14340.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14341.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14342.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14343.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14344.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14345.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14346.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14347.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14348.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14349.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14350.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14351.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14352.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14353.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14354.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14355.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14356.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14357.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14358.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14359.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14360.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14361.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14362.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14363.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14364.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14365.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14366.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14367.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14368.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14369.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14370.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14371.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14372.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14373.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14374.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14375.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14376.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14377.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14378.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14379.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14380.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14381.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14382.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14383.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14384.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14385.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14386.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14387.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14388.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14389.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14390.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14391.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14392.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14393.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14394.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14395.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14396.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14397.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14398.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14399.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14400.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14401.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14402.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14403.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14404.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14405.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14406.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14407.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14408.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14409.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14410.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14411.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14412.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14413.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14414.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14415.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14416.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14417.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14418.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14419.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14420.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14421.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14422.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14423.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14424.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14425.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14426.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14427.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14428.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14429.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14430.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14431.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14432.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14433.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14434.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14435.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14436.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14437.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14438.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14439.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14440.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14441.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14442.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14443.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14444.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14445.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14446.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14447.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14448.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14449.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14450.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14451.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14452.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14453.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14454.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14455.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14456.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14457.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14458.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14459.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14460.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14461.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14462.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14463.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14464.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14465.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14466.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14467.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14468.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14469.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14470.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14471.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14472.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14473.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14474.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14475.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14476.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14477.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14478.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14479.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14480.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14481.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14482.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14483.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14484.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14485.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14486.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14487.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14488.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14489.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14490.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14491.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14492.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14493.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14494.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14495.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14496.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14497.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14498.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14499.html
 推荐查看成语：https://www.tianqi556.com/chengyu/14500.html

在 TypeScript 项目里调用 JSON.parse(localStorage.getItem('user') ?? '{}') 之后，多数人下意识会直接访问 user.name、user.email，编辑器既不报错也不提示，直到线上运行时因为某个字段缺失或者类型不对炸掉。问题根源是 JSON.parse 的签名返回 any，它把类型检查整个绕过去了，而 any 又会沿着属性访问、函数传参悄悄污染下去。这篇文章从 lib.es5.d.ts 里的定义讲起，说清楚为什么标准库不把它改成 unknown，以及在实际业务里怎么用运行时校验、类型守卫和第三方 schema 库把这块缺口补上，让解析出来的数据真正受控，而不是靠 as User 硬断言的自我安慰。

TypeScript 中 JSON.parse 的返回值为什么是 any，以及如何安全地处理它

在 TypeScript 项目里调用 JSON.parse(localStorage.getItem('user') ?? '{}') 之后，多数人下意识会直接访问 user.name、user.email，编辑器既不报错也不提示，直到线上运行时因为某个字段缺失或者类型不对炸掉。问题根源是 JSON.parse 的签名返回 any，它把类型检查整个绕过去了，而 any 又会沿着属性访问、函数传参悄

编程语言

前端

TypeScript项目解析本地存储时，JSON.parse返回any导致类型检查失效，运行时易出错。本文解析标准库定义，通过unknown收窄、类型守卫及zod schema校验，实现数据可控。混合策略推荐：内部数据用带fallback封装，跨边界数据一律schema验证，避免any污染扩散。

代码解释

TypeScript 

编译器

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

TypeScript 中 JSON.parse 的返回值为什么是 any，以及如何安全地处理它-腾讯云开发者社区-腾讯云

TypeScript 中 JSON.parse 的返回值为什么是 any，以及如何安全地处理它

TypeScript 中 JSON.parse 的返回值为什么是 any，以及如何安全地处理它

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐