tsconfig严格模式

1. strict 总开关

{
  "compilerOptions": {
    "strict": true
  }
}

strict: true 等价于同时启用以下所有选项：

2. 核心选项详解

2.1 noImplicitAny

//  隐式 any
function parse(input) {
  // Parameter 'input' implicitly has an 'any' type
  return input.trim();
}

//  显式类型
function parse(input: string): string {
  return input.trim();
}

2.2 strictNullChecks

//  null 不安全
let name: string = null; // Error

//  明确包含 null
let name: string | null = null;

// 可选链
function greet(name: string | null) {
  console.log(name?.toUpperCase());
}

// 类型守卫
function process(value: string | null) {
  if (value === null) return;
  console.log(value.toUpperCase()); // string
}

2.3 strictFunctionTypes

// 函数参数逆变
type AnimalHandler = (animal: Animal) => void;
type DogHandler = (dog: Dog) => void;

let handler: AnimalHandler = (dog: Dog) => {}; //  不安全

2.4 strictPropertyInitialization

class User {
  name: string; //  属性未初始化

  constructor() {}

  //  方式一：构造函数中初始化
  // constructor() { this.name = ''; }

  //  方式二：确定赋值断言
  // name!: string;

  //  方式三：可选属性
  // name?: string;
}

3. 其他推荐选项

{
  "compilerOptions": {
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noImplicitReturns": true,
    "noFallthroughCasesInSwitch": true,
    "forceConsistentCasingInFileNames": true,
    "exactOptionalPropertyTypes": true
  }
}

noUncheckedIndexedAccess

const arr = [1, 2, 3];
const item = arr[10]; // number | undefined

const obj: Record<string, string> = {};
const value = obj.key; // string | undefined

4. 渐进式迁移

// 逐步启用严格选项
{
  "compilerOptions": {
    "strictNullChecks": true, // 第一步
    "noImplicitAny": true, // 第二步
    "strict": true // 最终目标
  }
}

对于难以修复的文件，使用 // @ts-nocheck 或 // @ts-ignore 临时跳过。