JavaScript / TypeScript / 系统课时

strict 严格模式

strict 严格模式

本课解决空值、隐式 any 和属性未初始化等问题。你将理解 strict 的整体作用,并学会在新项目或存量项目中安全启用。

学习目标

  • 理解 strict 的检查范围
  • 修复常见严格模式错误
  • 设计渐进启用顺序

开启严格模式

json
{
  "compilerOptions": {
    "strict": true,
    "noEmit": true
  }
}

strict 会启用一组相互关联的检查。具体子选项可能随 TypeScript 版本变化,应查看最终配置。

bash
npx tsc --showConfig

预期结果

text
输出最终配置,其中 strict 为 true

处理空值和隐式 any

ts
// 缺失名称走显式默认分支
function upperName(name: string | undefined): string {
  return name?.toUpperCase() ?? "UNKNOWN";
}

function multiply(a: number, b: number): number {
  return a * b;
}

console.log(upperName(undefined), multiply(4, 5));

预期输出

text
UNKNOWN 20

严格模式要求代码明确处理 undefined,并为无法推断的参数提供类型。修复时应表达真实业务约束,不要用大量 any 消除错误。

属性初始化

ts
class Session {
  constructor(
    readonly id: string,
    readonly expiresAt: Date
  ) {}
}

console.log(new Session("s1", new Date("2026-08-01")).id);

预期输出

text
s1

实例字段必须在声明处或构造函数中可靠赋值。框架注入场景使用断言时,还应提供运行时验证。

存量项目迁移

可先处理 noImplicitAny,再开启 strictNullChecks,最后启用完整 strict。每批修复后运行:

bash
npx tsc --noEmit && npm test

预期结果

text
类型检查通过,随后现有测试全部成功

分清严格检查与额外选项

strict 是一组开关,不包含所有可能的安全检查。例如 noUncheckedIndexedAccess 和 exactOptionalPropertyTypes 需要单独评估启用。针对当前编译器版本查看 showConfig,再记录项目显式覆盖的子选项,不能认为一个 strict: true 就保证所有数组读取都检查越界。

在一个独立项目里保存配置和两个示例,确保 tsconfig 的 include 确实包含文件。运行 tsc --noEmit 通过只能说明被包含的代码通过检查,不能证明运行时接口输入正确。可临时加入没有参数类型的函数和直接读取可空值的表达式,确认出现报错,再撤销负例。

迁移时按模块修复真实约束,并让现有测试验证业务行为;非空断言和 definite assignment 断言不会创建值或等待注入完成。框架负责初始化字段时要有启动检查。示例末尾的 npm test 指项目已有测试脚本,新建练习项目尚未定义该脚本时只运行类型检查,不承诺不存在的测试自动通过。

独立验证

使用 TypeScript 5.9.3 和 Node.js 22 检查本节。分别运行名称默认值与 Session 初始化示例。临时添加无注解参数,确认 noImplicitAny 报错;再检查可空值访问,避免用非空断言掩盖真实缺失。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

strict 严格模式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通