JavaScript / TypeScript / 系统课时

启用严格模式

启用严格模式

strict 是 TypeScript 新项目最重要的类型检查基线。启用后,编译器会更早发现隐式 any、空值误用和不安全异常处理等问题,让错误停在开发阶段,而不是进入运行环境。

学习目标

  • 理解 strict 与各项严格检查之间的关系
  • 在 tsconfig.json 中启用并验证严格模式
  • 掌握旧项目渐进迁移时的安全做法

strict 到底检查什么

strict: true 不是单独的一条检查规则,而是一组严格类型检查的总开关。它会统一启用多项约束;不同 TypeScript 版本可能扩充这组规则,因此升级编译器后应重新运行类型检查。

常见检查 主要发现的问题
noImplicitAny 参数或变量被隐式推断为 any
strictNullChecks null、undefined 被当作普通值误用
strictFunctionTypes 函数参数类型存在不安全兼容
strictPropertyInitialization 类属性声明后没有可靠初始化
useUnknownInCatchVariables 未确认异常类型就直接读取属性

项目可以在启用 strict 后单独覆盖某个选项,但这会降低统一基线的可读性。新项目应优先保持总开关开启,再针对确有原因的例外添加说明。

配置并验证 strict

在项目根目录创建或修改 tsconfig.json。下面的配置只执行类型检查,不生成 JavaScript 文件,适合在本地检查和持续集成中使用。

json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "CommonJS",
    "strict": true,
    "noEmit": true
  },
  "include": ["index.ts"]
}

将以下代码保存为 index.ts。它故意包含三类严格模式错误,用于确认配置已经生效。

ts
function greet(name) {
  return `Hello, ${name}`;
}

let title: string = null;

try {
  throw new Error("failed");
} catch (error) {
  console.log(error.message);
}

在已安装 TypeScript 的项目中运行:

bash
npx tsc

预期输出如下。文件位置可能不同,但错误代码和对应问题应一致。

text
index.ts(1,16): error TS7006: Parameter 'name' implicitly has an 'any' type.
index.ts(5,5): error TS2322: Type 'null' is not assignable to type 'string'.
index.ts(10,15): error TS18046: 'error' is of type 'unknown'.

这说明编译器已经阻止隐式 any、不合法空值和未经缩小的异常对象。不要通过改成 any 消除红线,应补充真实类型或增加运行时判断。

修复严格模式错误

为参数声明类型;确实允许空值时使用联合类型;捕获异常后先将其视为 unknown,再通过类型缩小读取属性。

ts
function greet(name: string): string {
  return `Hello, ${name}`;
}

let title: string | null = null;
title = "TypeScript";

try {
  throw new Error("failed");
} catch (error: unknown) {
  if (error instanceof Error) {
    console.log(error.message);
  }
}

console.log(greet(title));

再次运行类型检查:

bash
npx tsc

预期输出:

text
无输出,进程退出码为 0。

noEmit: true 会让成功检查保持静默。如果需要生成 JavaScript,应移除该选项,或在构建命令中使用另一份构建配置。

旧项目的渐进迁移

旧项目一次性开启 strict 可能产生大量诊断。更稳妥的顺序是先固定 TypeScript 版本并记录当前错误数,再按目录或模块修复,最后把 npx tsc --noEmit 加入持续集成。

迁移期间可以暂时覆盖个别选项,例如保留 strict: true,同时短期设置 strictNullChecks: false。这种例外必须附带清理计划,否则配置会逐渐失去约束力。

常见误区是使用大量非空断言 !、类型断言 as 或 any 快速清除错误。这些写法会绕过编译器,应只在已经通过运行时校验、第三方声明不准确或边界数据已被可信转换时使用。

本课总结

  • strict 是一组严格检查的统一入口,适合作为新项目默认基线
  • 验证配置应运行 tsc,并根据诊断修复真实类型问题
  • 旧项目应分阶段迁移,避免用 any 和断言掩盖风险

下一课预告

下一课将使用编辑器的悬停提示、跳转定义、符号重命名和诊断面板,把 TypeScript 的类型信息直接融入日常编码流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

启用严格模式

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

登录哪都通