已正确声明类型仍无法给Node.js全局对象赋值：编译时出现“无索引签名”错误（IDE无报错）

这种IDE提示正常但编译报错的情况确实挺让人困惑的，我之前也遇到过类似问题。核心原因是你当前的类型声明没有正确关联到Node.js global 对象的实际类型上，导致TypeScript编译时无法识别global.property的类型，而IDE因为缓存了全局变量的声明信息，所以能正常提供补全。

解决方案1：扩展Node.js的Global接口（推荐） #

Node.js中的global对象类型属于NodeJS.Global接口，你之前的声明只是在全局作用域添加了一个变量，但没有把这个属性合并到global对象的类型定义里。修改你的类型声明文件：

// types/global.d.ts
declare global {
  namespace NodeJS {
    interface Global {
      property: string;
    }
  }
}

// 必须添加这行确保文件被识别为模块
export {};

这样TypeScript会自动把property属性合并到global对象的类型中，编译时就不会再报“无索引签名”的错误了。

解决方案2：改用globalThis并保持现有声明 #

Node.js的global是globalThis的别名，如果你改用globalThis，之前的全局变量声明就能直接生效：

1. 保持你的types/global.d.ts不变：

declare global {
  var property: string;
}

export {};

2. 修改代码中的赋值语句：

// src/app.ts
app.use((req, res, next) => {
  globalThis.property = 'test'; // 改用globalThis
  next();
});

这种方式更符合ES标准，globalThis的类型会自动包含你在全局作用域声明的变量。

额外检查：确保TypeScript正确加载类型声明 #

虽然你的tsconfig.json配置看起来没问题，但可以再确认以下几点：

• typeRoots中的路径写成["./types", "./node_modules/@types"]（添加./确保相对路径正确）
• 执行编译前，重启VS Code的TypeScript服务（快捷键Ctrl+Shift+P，选择「TypeScript: Restart TS Server」），避免IDE缓存旧的类型信息
• 确认include数组确实包含了types/**/*，让TypeScript编译时扫描到自定义类型文件

为什么IDE和编译结果不一致？ #

VS Code的TypeScript服务会实时缓存类型信息，可能提前识别到了你声明的全局变量；但tsc编译时会重新完整扫描所有类型文件和配置，对类型一致性的检查更严格，所以会暴露类型声明和实际对象类型不匹配的问题。

内容来源于stack exchange