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 文件,适合在本地检查和持续集成中使用。
{
"compilerOptions": {
"target": "ES2022",
"module": "CommonJS",
"strict": true,
"noEmit": true
},
"include": ["index.ts"]
}将以下代码保存为 index.ts。它故意包含三类严格模式错误,用于确认配置已经生效。
function greet(name) {
return `Hello, ${name}`;
}
let title: string = null;
try {
throw new Error("failed");
} catch (error) {
console.log(error.message);
}在已安装 TypeScript 的项目中运行:
npx tsc预期输出如下。文件位置可能不同,但错误代码和对应问题应一致。
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,再通过类型缩小读取属性。
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));再次运行类型检查:
npx tsc预期输出:
无输出,进程退出码为 0。noEmit: true 会让成功检查保持静默。如果需要生成 JavaScript,应移除该选项,或在构建命令中使用另一份构建配置。
旧项目的渐进迁移
旧项目一次性开启 strict 可能产生大量诊断。更稳妥的顺序是先固定 TypeScript 版本并记录当前错误数,再按目录或模块修复,最后把 npx tsc --noEmit 加入持续集成。
迁移期间可以暂时覆盖个别选项,例如保留 strict: true,同时短期设置 strictNullChecks: false。这种例外必须附带清理计划,否则配置会逐渐失去约束力。
常见误区是使用大量非空断言 !、类型断言 as 或 any 快速清除错误。这些写法会绕过编译器,应只在已经通过运行时校验、第三方声明不准确或边界数据已被可信转换时使用。
本课总结
strict是一组严格检查的统一入口,适合作为新项目默认基线- 验证配置应运行
tsc,并根据诊断修复真实类型问题 - 旧项目应分阶段迁移,避免用
any和断言掩盖风险
下一课预告
下一课将使用编辑器的悬停提示、跳转定义、符号重命名和诊断面板,把 TypeScript 的类型信息直接融入日常编码流程。