代码术语:alias

alias(别名)

alias(别名) 就是“给已经存在的某个东西起的另一个名字”。在 TypeScript 代码里,这个词出现在三个完全不同的场景,含义也不一样:类型别名、导入/导出别名、路径别名。

用 type 给一个类型起名字,之后就能当类型使用。

type UserId = string | number;              // 联合类型
type Point = { x: number; y: number };      // 对象结构
type Handler = (e: Event) => void;          // 函数类型
type Pair = [number, number];               // 元组
type Status = "idle" | "loading" | "done";  // 字面量联合,常用于状态机
 
const id: UserId = 123;
const p: Point = { x: 1, y: 2 };

特点:

  • 只是起名字,不产生新类型,编译后完全消失(零运行时开销)
  • 能描述任意类型:联合、交叉、元组、原始类型、泛型都可以
  • 不能同名声明合并,重复写两个同名 type 会报错
// 导入时改名,常用于解决命名冲突
import { createUser as addUser } from "./user";
import { createUser as createAdminUser } from "./admin";
 
// 命名空间导入
import * as utils from "./utils";
 
// 导出时改名
export { internalImpl as publicApi };
 
// 默认导入同样可以起任意本地名字
import MyComponent from "./MyComponent";

要注意:as 在类型断言里(value as string)与别名无关,那是“断言”不是“改名”。

让 @/xxx 这类短路径代替 ../../xxx 这种相对路径。

// tsconfig.json
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
    }
  }
}
import { Button } from "@/components/Button";

要点:

  • tsconfig 的 paths 只影响类型检查,不会改写运行时真正加载的模块路径
  • 运行时还要打包工具配合,否则报 “Cannot find module”:
    • Vite:resolve.alias
    • webpack:resolve.alias
    • Node 直接跑 TS:tsconfig-paths 或在打包器里处理
// vite.config.ts
import { defineConfig } from "vite";
import path from "path";
 
export default defineConfig({
  resolve: {
    alias: { "@": path.resolve(__dirname, "src") }
  }
});
对比项 type interface
描述对象结构 可以 可以(更常用)
联合 / 元组 / 原始类型 可以 不可以
同名声明合并 不可以 可以
扩展方式 交叉类型 A & B extends
编译后产物 消失 消失

经验:描述对象、需要扩展或声明合并时用 interface;联合类型、元组、函数类型、给复杂类型起个短名字时用 type。

  • 配了路径别名却忘了打包工具 → 编译通过、运行时报 Cannot find module
  • 想给第三方类型“打补丁”(声明合并)只能用 interface,type 做不到
  • 别名不改变类型本质:type A = string 中 A 和 string 完全互相兼容,不会带来额外的类型安全
  • 别名满天飞会让人找不到定义,公共别名建议集中放在 types.ts 里统一维护

返回:代码术语

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/alias.txt
  • 最后更改: 2026/10/10 23:25
  • 由 张叶安