理解 unknown 与 any
了解为什么 unknown 是比 any 更安全的类型选择。
理解 unknown 与 any 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。
两个顶层类型
TypeScript 有两种可以容纳任意值的类型：any 和 unknown。它们看起来相似，但行为却大不相同。选择正确的类型是编写类型安全代码的核心技能。
let a: any = 5;
let u: unknown = 5;
console.log(a, u);any 会禁用类型检查
any 是一种逃生通道，会关闭对该值的类型检查。您可以访问任意属性，也可以像调用函数一样调用它；即使运行时会发生崩溃，编译器也会保持沉默。
const a: any = 'hello';
console.log(a.toUpperCase()); // OK
// a.doesNotExist(); // no compile error, but crashes at runtimeunknown 强制您进行检查
unknown 同样接受任意值，但在证明它是什么之前，您不能使用它。编译器会阻止属性访问和调用，直到您将类型缩小。
const u: unknown = 'hello';
// console.log(u.toUpperCase()); // Error: u is unknown
console.log(typeof u);使用 typeof 缩小 unknown
typeof 守卫会在代码块内将 unknown 缩小为具体类型。缩小之后，您就可以安全地使用该类型的所有方法。
function shout(value: unknown): string {
if (typeof value === 'string') {
return value.toUpperCase(); // safe here
}
return 'not a string';
}
console.log(shout('hi'), shout(42));unknown 为什么更安全
unknown 表示诚实的不确定性：“我目前还不知道这是什么。”它会促使您在使用前进行验证，从而在编译时捕获错误。any 只会隐藏不确定性和错误。
function len(value: unknown): number {
if (typeof value === 'string') return value.length;
if (Array.isArray(value)) return value.length;
return 0;
}
console.log(len('abc'), len([1, 2]), len(99));向 unknown 赋值以及从 unknown 赋值
任何值都可以赋给 unknown。但是，unknown 只能赋给 unknown 或 any，如果不先缩小类型，就不能赋给具体类型。这种不对称性正是它保持安全的原因。
let u: unknown = 10;
u = 'now a string';
u = true;
const anyVal: any = u; // allowed
console.log(anyVal);
// const s: string = u; // Errorany 会在代码中扩散
any 的一个危险特性是它会扩散。一旦某个值成为 any，从它派生的任何内容也会变成 any，从而在不知不觉中削弱整个程序的类型安全性。
const a: any = { count: 5 };
const total = a.count + 10; // total is any
const flag = total.whatever; // still any, no error
console.log(total);unknown 将风险限制在原处
使用 unknown 时，不确定性会停留在原处。您必须在每个边界显式缩小类型，因此不安全的操作无法泄漏到其他位置。风险会被控制在它应处的位置。
const u: unknown = { count: 5 };
if (typeof u === 'object' && u !== null && 'count' in u) {
console.log('Has count property');
}为 API 和 JSON 边界添加类型
外部数据——JSON、网络响应和用户输入——没有任何保证。将其标注为 unknown 而不是 any，会强制您在信任它之前进行验证，这是安全的默认做法。
function parse(text: string): unknown {
return JSON.parse(text);
}
const data = parse('{"id":1}');
if (typeof data === 'object' && data !== null) {
console.log('Got an object');
}何时可以接受 any
any 有时很实用，例如快速原型、从 JavaScript 渐进式迁移，或与无类型库互操作。但请把它当作临时标记，而不是习惯。只要可能，就优先使用 unknown。
// Migration placeholder, to be typed later
let legacy: any = getLegacyValue();
function getLegacyValue() { return { x: 1 }; }
console.log(legacy.x);实际比较
并排比较可以看到：any 版本能够编译，但可能在运行时崩溃；unknown 版本则拒绝编译不安全的访问。编译器正在履行职责——保护您。
const a: any = 42;
console.log(a.toFixed(2)); // OK by luck
const u: unknown = 42;
if (typeof u === 'number') {
console.log(u.toFixed(2)); // checked, safe
}快速检查
测试您对 unknown 和 any 的理解。
回顾：unknown 与 any
要点：
any会禁用类型检查，并在派生值中扩散。unknown接受任意值，但会阻止使用，直到您将其缩小。- 对于外部数据（JSON、API 和用户输入），请使用
unknown来强制进行验证。 - 将
any保留给迁移或无类型互操作场景，并把它作为临时标记。
接下来，我们将探索空类型：never。
function safeLen(v: unknown): number {
return typeof v === 'string' ? v.length : 0;
}
console.log(safeLen('hello'), safeLen(123));
用 AI 导师学习 TypeScript — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 101
- 课程
- 352
常见问题解答
「理解 unknown 与 any」课时是免费的吗？
是的 — 「理解 unknown 与 any」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。
「理解 unknown 与 any」这节课中我会学到什么？
了解为什么 unknown 是比 any 更安全的类型选择。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 TypeScript Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「理解 unknown 与 any」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 TypeScript Academy 课中编写并运行代码吗？
能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 理解 unknown 与 any
- never 类型与不可能状态
- 函数中的 void 类型
- 类型安全地处理 unknown