跳到主要内容

1 / 4概念

Toolchain: Declarations and Config

类型从哪来、编译器怎么找到它、项目怎么串起来,这三件事决定了类型检查是否可信。判断标准不是会不会改 tsconfig,而是能否说清一次 import 走了哪条解析路径,以及结果为什么与运行时一致。

1 概念​

1.1 一句话定义​

类型来源只有三种:源码、声明文件、推断。编译器按模块解析规则找到声明,按 tsconfig 决定检查强度与输出。.d.ts 只描述形状,不产生任何运行时代码。

1.2 它解决什么问题​

  • 给无类型代码补类型:老包、全局脚本、动态加载的模块都能有声明。
  • 让三方一致:编辑器、CI 和打包器读同一份配置,结论一致。
  • 多包增量构建:references 让子包只重编改动的部分。
  • 发布类型:库把 .d.ts 一起发布,使用者获得补全与检查。

1.3 不属于本页的内容​

主题去哪
收窄、可赋值性Types and Narrowing
泛型与类型运算Generics and Operators
打包器与包管理器的运行时配置Toolchain
Node 的模块加载与 require 语义Runtime Environment
发布流水线仓库运维章节

1.4 关键术语​

术语含义容易混淆的点
声明文件.d.ts,只含类型不产生运行时代码
环境声明用 declare 描述已存在的值不创建值
模块扩充declare module 在已有模块上加成员文件必须先是模块才生效
全局扩充declare global只能写在模块文件里
模块解析从导入路径找到文件与运行时解析可能不同
exports 条件按 import/require 分支导出顺序决定命中
paths编译期路径别名运行时要另配
项目引用包之间的依赖声明需要 composite
isolatedModules每个文件独立转译类型导入必须显式
装饰器类与成员的元编程语法有两套不兼容的语义