如何在TypeScript中局部启用strictNullCheck规则？

针对大型TypeScript项目中仅局部模块开启strictNullChecks的需求，以下是几种实用方案：

1. 利用项目引用（Project References）拆分独立子项目 #

这是最规范的长期解决方案，适合模块边界清晰的场景：

• 将你负责的模块拆分为独立的子项目，单独创建tsconfig.json并开启strictNullChecks: true。
• 为项目中其他依赖模块配置tsconfig.json，确保开启declaration: true（生成类型声明文件.d.ts），但保持strictNullChecks: false不变。
• 在你的模块的tsconfig.json中通过references字段引入依赖模块，编译时TypeScript会使用依赖模块的.d.ts文件而非源码，避免被依赖模块的null/undefined类型问题干扰。

示例配置（你的模块的tsconfig.json）：

{
  "compilerOptions": {
    "strictNullChecks": true,
    "declaration": true,
    "outDir": "./dist",
    "rootDir": "./src"
  },
  "references": [
    { "path": "../shared-utils" },
    { "path": "../common-components" }
  ],
  "include": ["./src/**/*"]
}

优点：类型隔离彻底，不影响全局项目，适合长期维护；缺点：需要调整项目结构，配置稍繁琐。

2. 本地类型覆盖与断言 #

如果依赖模块不多，可通过类型断言或模块扩充修正依赖类型：

• 类型断言：对依赖模块返回的可能为null/undefined的值，直接用as NonNullable<T>断言为非空类型，快速绕过报错：

  import { fetchUserInfo } from "../legacy-module";
  // 断言返回值非空，需确保业务逻辑中该值确实不会为null
  const userInfo = fetchUserInfo() as NonNullable<ReturnType<typeof fetchUserInfo>>;
  

• 模块扩充：创建本地类型声明文件，覆盖依赖模块的类型定义，移除null/undefined：

  // src/types/legacy-module.d.ts
  declare module "../legacy-module" {
    export function fetchUserInfo(): { id: string; name: string };
  }
  

优点：无需调整项目结构，快速生效；缺点：依赖类型变更时需同步维护本地声明，适合依赖稳定的场景。

3. 临时跳过特定报错 #

对于零散的依赖类型问题，可使用单行注释临时跳过，但需谨慎使用并标注原因：

• // @ts-ignore：跳过当前行的所有TypeScript报错
• // @ts-expect-error：明确预期当前行报错，若后续依赖修复后报错消失，该注释会触发新的提示（更推荐）

示例：

// @ts-expect-error 旧模块未开启strictNullChecks，经测试该值始终存在
const config = getLegacyConfig();

优点：快速解决零散报错；缺点：可能掩盖真实问题，仅适合临时过渡。

4. 渐进式开启规则并排除依赖源码 #

在你的模块的tsconfig.json中开启strictNullChecks，同时通过include和exclude限定作用范围，避免编译依赖模块的源码：

{
  "compilerOptions": {
    "strictNullChecks": true
  },
  "include": ["./src/**/*"],
  "exclude": ["../**/src/**/*"] // 排除其他模块的源码，仅使用它们的.d.ts
}

同时确保项目根目录的tsconfig.json为依赖模块生成.d.ts文件（开启declaration: true）。

优点：无需拆分项目，配置简单；缺点：若依赖模块未生成.d.ts，可能出现类型缺失问题。

内容的提问来源于stack exchange，提问作者Sheppard25