0

0

TypeScript 中 keyof 在嵌套映射类型中的误用与正确实践

霞舞

霞舞

发布时间:2026-02-10 20:57:49

|

126人浏览过

|

来源于php中文网

原创

TypeScript 中 keyof 在嵌套映射类型中的误用与正确实践

本文解析为何在 `in keyof item[k]` 这类嵌套映射类型中,`keyof` 会意外引入 `string`/`number` 原始类型的原型方法(如 `charat`、`tofixed`),并给出语义清晰、类型安全的替代写法。

在 TypeScript 的高级类型编程中,keyof 是一个强大而易被误解的工具。它本意是提取对象类型(object type)的可索引键名联合,例如:

type Point = { x: number; y: number };
type Keys = keyof Point; // "x" | "y"

但当 keyof 被错误地应用于非对象类型(如字面量联合类型 ItemType、Owner 或 Value)时,TypeScript 会将其“升格”为对应原始类型的完整键集合——即 keyof string 或 keyof number,而这正是问题根源。

以原问题为例:

type ItemType = 'itemTypeA' | 'itemTypeB';
type Owner = 'ownerA' | 'ownerB';
type Value = 1 | 2;

type Item = {
  type: ItemType;
  owner: Owner;
  value: Value;
};

// ❌ 错误:keyof Item[K] 对于 K="type" 即 keyof ItemType
// 由于 ItemType 是字符串字面量联合,TypeScript 将其视为 string 的子类型,
// 因此 keyof ItemType 等价于 keyof string → 所有 string 原型方法键:
// "toString" | "charAt" | "charCodeAt" | "indexOf" | ...(共数十个)
type AnotherType = {
  [K in keyof Item]: null | {
    [M in keyof Item[K]]: number; // ← 问题在此!
  };
};

此时 Item["type"] 是 'itemTypeA' | 'itemTypeB',属于 string 子类型;keyof Item["type"] 并非你期望的 "itemTypeA" | "itemTypeB",而是 string 的所有可枚举属性键(包括继承自 String.prototype 的方法)。同理,keyof Value(即 keyof (1 | 2))等价于 keyof number,会引入 toFixed、toPrecision 等方法名,导致类型宽泛且无法赋值。

✅ 正确做法是:直接遍历 Item[K] 本身,因为该类型已是所需的键字面量联合(ItemType、Owner、Value),无需再取其 keyof:

type AnotherType = {
  [K in keyof Item]: null | {
    [M in Item[K]]: number; // ✅ 直接用 Item[K] —— 它本身就是键集合
  };
};

这样,TypeScript 将精确推导为:

采风问卷
采风问卷

采风问卷是一款全新体验的调查问卷、表单、投票、评测的调研平台,新奇的交互形式,漂亮的作品,让客户眼前一亮,让创作者获得更多的回复。

下载
  • K = "type" → M in ItemType → "itemTypeA" | "itemTypeB"
  • K = "owner" → M in Owner → "ownerA" | "ownerB"
  • K = "value" → M in Value → 1 | 2

最终 AnotherType 的结构完全符合预期:

type AnotherType = {
  type: { itemTypeA: number; itemTypeB: number } | null;
  owner: { ownerA: number; ownerB: number } | null;
  value: { 1: number; 2: number } | null;
};

✅ 赋值成功:

const v: AnotherType = {
  type: { itemTypeA: 0, itemTypeB: 1 },
  owner: { ownerA: 0, ownerB: 1 },
  value: null,
};

⚠️ 关键注意事项

  • keyof T 仅对对象类型有意义;对原始类型(string、number、boolean)或其字面量联合使用 keyof,会退化为该原始类型的完整原型键集合。
  • 映射类型中 in T 的 T 应为键类型集合(如字面量联合),而非“键的键”;若 T 已是 ItemType,则 in ItemType 正确,in keyof ItemType 错误。
  • 可借助 --noImplicitAny 和类型检查器提示(如 VS Code 悬停查看 keyof Item["type"] 展开结果)提前发现此类误用。

总结:keyof 不是万能的“取所有可能属性名”的黑盒操作;它的行为严格依赖于操作数的类型分类。在设计嵌套映射类型时,始终问自己:“这里需要的是 键本身,还是 键的键?”——绝大多数场景下,你需要的是前者。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

668

2023.08.02

java中boolean的用法
java中boolean的用法

在Java中,boolean是一种基本数据类型,它只有两个可能的值:true和false。boolean类型经常用于条件测试,比如进行比较或者检查某个条件是否满足。想了解更多java中boolean的相关内容,可以阅读本专题下面的文章。

356

2023.11.13

java boolean类型
java boolean类型

本专题整合了java中boolean类型相关教程,阅读专题下面的文章了解更多详细内容。

35

2025.11.30

包子漫画网页版入口与全集阅读指南_正版免费漫画快速访问方法
包子漫画网页版入口与全集阅读指南_正版免费漫画快速访问方法

本专题汇总了包子漫画官网和网页版入口,提供最新章节抢先看方法、正版免费阅读指南,以及稳定访问方式,帮助用户快速直达包子漫画页面,无广告畅享全集漫画内容。

47

2026.02.10

MC.JS网页版快速畅玩指南_MC.JS官网在线入口及免安装体验方法
MC.JS网页版快速畅玩指南_MC.JS官网在线入口及免安装体验方法

本专题汇总了MC.JS官网入口和网页版快速畅玩方法,提供免安装访问、不同版本(1.8.8、1.12.8)在线体验指南,以及正版网页端操作说明,帮助玩家轻松进入MC.JS世界,实现即时畅玩与高效体验。

35

2026.02.10

谷歌邮箱网页版登录与注册全指南_Gmail账号快速访问与安全操作教程
谷歌邮箱网页版登录与注册全指南_Gmail账号快速访问与安全操作教程

本专题汇总了谷歌邮箱网页版的最新登录入口和注册方法,详细提供官方账号快速访问方式、网页版操作教程及安全登录技巧,帮助用户轻松管理Gmail邮箱账户,实现高效、安全的邮箱使用体验。

27

2026.02.10

铁路12306订票与退改全攻略_高效购票与座位选取技巧
铁路12306订票与退改全攻略_高效购票与座位选取技巧

本专题全面汇总铁路12306订票、退票、改签及候补订单操作技巧,提供车厢座位分布参考、抢票攻略和高铁安检注意事项,帮助新手用户快速掌握高效购票与退改流程,提高出行效率和体验。

31

2026.02.10

TensorFlow2深度学习模型实战与优化
TensorFlow2深度学习模型实战与优化

本专题面向 AI 与数据科学开发者,系统讲解 TensorFlow 2 框架下深度学习模型的构建、训练、调优与部署。内容包括神经网络基础、卷积神经网络、循环神经网络、优化算法及模型性能提升技巧。通过实战项目演示,帮助开发者掌握从模型设计到上线的完整流程。

0

2026.02.10

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

4

2026.02.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
TypeScript 教程
TypeScript 教程

共19课时 | 2.8万人学习

TypeScript——十天技能课堂
TypeScript——十天技能课堂

共21课时 | 1.1万人学习

TypeScript-45分钟入门
TypeScript-45分钟入门

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号