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 只影响类型检查,不会改写运行时真正加载的模块路径resolve.aliasresolve.aliastsconfig-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 moduleinterface,type 做不到type A = string 中 A 和 string 完全互相兼容,不会带来额外的类型安全types.ts 里统一维护返回:代码术语