为何TypeScript默认认为document始终可用？如何让它识别其可能为undefined？

你遇到的问题是因为同时开启node和browser环境、并引入DOM库后，TypeScript会合并全局类型，默认认为document始终存在，导致ESLint的@typescript-eslint/no-unnecessary-condition规则报错。以下是几种可行的解决办法：

方案一：显式声明document的可选类型 #

在你使用document的文件顶部，手动添加全局变量的类型声明，覆盖默认的类型定义：

declare var document: Document | undefined;

这样TypeScript会明确知道document可能为undefined，ESLint的不必要条件检查就会通过。如果只是单个函数需要，也可以在函数内部用类型断言辅助：

const doc = document as Document | undefined;
if (!doc) return;

方案二：使用typeof检查替代直接判断 #

将原条件判断改为typeof检查，这种写法能被TypeScript和ESLint正确识别为跨环境的必要判断：

if (typeof document === 'undefined') return;

因为在Node.js环境中document未定义，typeof document会返回'undefined'，而浏览器环境中会返回'object'，ESLint会认可这个条件的必要性。

方案三：调整ESLint规则配置 #

如果不想修改代码，可以针对性调整@typescript-eslint/no-unnecessary-condition规则，允许这类跨环境的常量条件判断。在你的ESLint配置文件（如.eslintrc.json）中修改规则：

{
  "rules": {
    "@typescript-eslint/no-unnecessary-condition": [
      "error",
      {
        "allowConstantLoopConditions": true,
        "allowRuleToRunWithoutStrictNullChecks": true
      }
    ]
  }
}

或者在具体代码行上临时禁用该规则：

// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
if (!document) return;

不过这种方式属于绕过规则，更推荐前两种从类型层面解决问题的方案。

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