Typescript ESLint无法识别自定义Node.js全局类型声明文件问题

我之前碰到过一模一样的状况——VS Code能正常识别自定义的Global类型，但一跑ESLint就弹出TS2339错误。问题根源其实有两处：你的tsconfig.json没包含根目录的global.d.ts，而且ESLint的TypeScript解析器没正确读取项目的类型配置。

下面是具体的修复步骤：

1. 让TypeScript加载自定义声明文件 #

你的tsconfig.json里的include只覆盖了src/**/*.ts，根目录的global.d.ts不在这个范围内。虽然VS Code会自动扫描项目里的声明文件，但ESLint严格遵循tsconfig的配置规则，所以必须把声明文件加入include列表：

修改后的tsconfig.json：

{
  "compilerOptions": {
    "target": "es5",
    "module": "commonjs",
    "strict": true,
    "moduleResolution": "node",
    "baseUrl": "./src",
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*.ts", "./global.d.ts"],
  "exclude": ["node_modules"]
}

如果之后你把声明文件移到src目录下，可以把"./global.d.ts"改成"src/**/*.d.ts"，这样能自动匹配所有类型声明文件，更灵活。

2. 配置ESLint使用TypeScript的类型信息 #

@typescript-eslint/parser需要明确知道你的tsconfig.json位置，才能读取类型声明并完成正确的类型检查。在.eslintrc.js里添加parserOptions配置：

修改后的.eslintrc.js：

module.exports = {
  root: true,
  parser: '@typescript-eslint/parser',
  parserOptions: {
    project: './tsconfig.json',
    tsconfigRootDir: __dirname
  },
  env: { node: true },
  plugins: ['@typescript-eslint'],
  extends: ['eslint:recommended', 'plugin:@typescript-eslint/recommended'],
  rules: { ... },
};

project指定了tsconfig的路径，tsconfigRootDir确保解析器能正确定位到配置文件（尤其是项目结构复杂时更有用）。

3. 验证修复效果 #

做完上面的修改后，重启VS Code的ESLint服务（可以按Ctrl+Shift+P输入ESLint: Restart ESLint Server），再执行你的ESLint命令：

eslint -c ./.eslintrc.js --ext .ts,.js --fix ./src/**/*.{js,ts}

这时候应该就不会再报appRoot不存在的错误了。

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