TypeScript之字面量类型的使用详解

 更新时间:2025年12月28日 10:59:47   作者:无风听海  
在TypeScript中,字面量类型是值级别的类型,表示某个值本身就是类型的一部分,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

✳️ 一、什么是字面量类型(Literal Types)?

在 TypeScript 中,字面量类型(Literal Types)是值级别的类型,表示某个值本身就是类型的一部分。

常见的字面量类型包括:

字面量类型举例
数字1, 42, 0
字符串"hello", "yes"
布尔true, false

这些类型只接受对应的字面值:

type A = 1;
const x: A = 1;       // ✅ 合法
const y: A = 2;       // ❌ 报错:不能赋值 number 给类型 1

🧠 为什么要有字面量类型?

字面量类型让我们可以更严格、更精确地控制值的合法性。

比如在按钮组件中:

type ButtonSize = 'small' | 'medium' | 'large';

function createButton(size: ButtonSize) { ... }

createButton('medium'); // ✅
createButton('huge');   // ❌ 类型错误

✳️ 二、字面量类型 VS 基础类型的区别

字面量类型宽泛基础类型
'hello'string
1number
trueboolean

你可以认为字面量类型是基础类型的“子类型”。

let a: 'yes' = 'yes';       // ✅
let b: string = 'yes';      // ✅
a = b;                      // ❌ string 可能不等于 'yes'
b = a;                      // ✅ 'yes' 一定是 string

✳️ 三、什么时候会推断为字面量类型?

这是关键!我们来看 TypeScript 中推断为字面量类型的几种情况

✅ 1.const声明的变量,会推断为字面量类型

const a = 42;       // 推断为 42(字面量类型)
let b = 42;         // 推断为 number(更宽泛)
const s = "hello";  // 推断为 "hello"
let t = "hello";    // 推断为 string

🧠 原理: const 声明表示变量值不可变,所以可以精确地推断为值本身的类型。

✅ 2. 使用as const明确指定字面量类型

const arr = [1, 2, 3] as const;
// 推断为 readonly [1, 2, 3] (字面量元组)
const obj = {
  type: 'success',
  code: 200,
} as const;
// 推断为 { readonly type: 'success'; readonly code: 200 }

📌 as const 是字面量推断的强制方式,常用于需要精准类型的地方,比如 Redux、API 返回值、类型映射。

✅ 3. 明确写了字面量类型

当然,最直接的方法就是你直接指定类型:

let status: 'loading' | 'done' = 'loading';

❌ 不会推断为字面量类型的情况

情况推断类型原因
let a = 42;number因为 let 变量是可变的
const a = someFunc();非字面量如果返回值无法静态分析成字面量
const obj = { key: 'value' };{ key: string }对象属性默认是宽泛类型,除非加 as const

✳️ 四、推断字面量类型的实际应用场景

1. 联合类型的类型保护

type Action = 'increment' | 'decrement';

function reducer(action: Action) {
  if (action === 'increment') {
    // ✅ Narrowing to 'increment'
  }
}

2. 字面量值作为 discriminated union 的 tag

type Shape =
  | { kind: 'circle'; radius: number }
  | { kind: 'square'; side: number };

function getArea(shape: Shape) {
  if (shape.kind === 'circle') {
    return Math.PI * shape.radius ** 2;
  }
}

3. 使用as const提供精确值类型

const options = ['up', 'down'] as const;
type Direction = typeof options[number]; // 'up' | 'down'

✅ 总结:字面量类型核心知识表

知识点说明
字面量类型定义1, "hi", true 等
推断为字面量的条件const 声明、as const、手动指定字面量类型
推断不会是字面量的情况let、函数返回值、普通对象/数组字面量
实际用途更精确的类型检查、discriminated union、配置常量、枚举替代等

到此这篇关于TypeScript之字面量类型的使用详解的文章就介绍到这了,更多相关TypeScript 字面量类型内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • bootstrap下拉列表与输入框组结合的样式调整

    bootstrap下拉列表与输入框组结合的样式调整

    输入框组默认是div.input-group。接下来通过本文给大家介绍bootstrap下拉列表与输入框组结合的样式调整,感兴趣的朋友一起看看吧
    2016-10-10
  • js 弹出菜单/窗口效果

    js 弹出菜单/窗口效果

    想象一下,你把一个重要内容放在一个弹出窗口,又不聚集到这个窗口。让使用屏幕阅读器的同学情何以堪,只有当他们 tab 到这页面结束,还继续 tab,才可能找到这个弹窗
    2011-10-10
  • javascript(js) join函数使用方法介绍

    javascript(js) join函数使用方法介绍

    javascript(js) join函数使用方法介绍...
    2007-11-11
  • JavaScript 利用Cookie记录用户登录信息

    JavaScript 利用Cookie记录用户登录信息

    JavaScript与Cookie之利用Cookie记录用户登录信息
    2009-12-12
  • JavaScript ES6中类与模块化管理超详细讲解

    JavaScript ES6中类与模块化管理超详细讲解

    JavaScript中的模块化是指将每个js文件会被认为单独一个的模块。模块之间是互相不可见的。如果一个模块需要使用另一个模块,那么需要通过指定语法来引入要使用的模块,而且只能使用引入模块所暴露的内容
    2023-01-01
  • javascript中的set的常用方法和操作

    javascript中的set的常用方法和操作

    这篇文章主要介绍了javascript中的set的常用方法和操作,在JavaScript中Set是一种特殊的数据结构,用于存储唯一的值,创建Set对象可以通过new Set()实现,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-11-11
  • JavaScript实现的鼠标响应颜色渐变效果完整实例

    JavaScript实现的鼠标响应颜色渐变效果完整实例

    这篇文章主要介绍了JavaScript实现的鼠标响应颜色渐变效果,涉及javascript面向对象及事件监听、响应机制相关操作技巧,需要的朋友可以参考下
    2017-02-02
  • 前端监控页面异常的常用方法

    前端监控页面异常的常用方法

    前端开发常见问题之一: 资源异常、js异常,页面出了问题常见的想法是:如何看到错误信息,资源脚本是否正常,像js、css、图片这些资源文件经常受网络等原因,导致资源加载异常,这些会直接影响我们的页面,本文给大家介绍前端监控页面异常的常用方法,需要的朋友可以参考下
    2025-04-04
  • js实现用户输入的小写字母自动转大写字母的方法

    js实现用户输入的小写字母自动转大写字母的方法

    下面小编就为大家带来一篇js实现用户输入的小写字母自动转大写字母的方法。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-01-01
  • js中map()函数的使用案例详解

    js中map()函数的使用案例详解

    map()方法定义在JavaScript的Array中,它返回一个新的数组,数组中的元素为原始数组调用函数处理后的值,这篇文章主要介绍了js中map()函数的使用,需要的朋友可以参考下
    2022-11-11

最新评论