安装@types/node后Node内置模块类型为any的问题排查

你的配置确实存在可能导致类型加载失败的问题，按优先级排查修复即可：

核心配置问题 #

• 缺失moduleResolution显式配置
  你仅指定了module: "commonjs"，但没有配置对应的模块解析规则。不同版本的TS、ts-node与原生tsc的默认模块解析行为存在差异，未显式指定时很容易出现模块定位失败，无法匹配@types/node中提供的内置模块类型声明。
  修复方式：在compilerOptions中添加"moduleResolution": "node"，如果使用TS 5.0+版本，可以替换为"node16"或"nodenext"适配新的解析逻辑。

• 自定义typeRoots路径存在失效风险
  你配置的"typeRoots": ["./node_modules/@types"]是相对tsconfig.json文件所在目录解析的，如果tsconfig.json没有放在和node_modules同级的项目根目录，这个路径会指向不存在的位置，TS根本扫描不到@types/node的类型文件。
  修复方式：直接删除自定义的typeRoots配置，TS默认就会递归向上查找所有层级node_modules下的@types目录，比手动写相对路径稳定得多。

其他常见触发场景 #

改完上述配置如果仍存在类型为any的问题，逐一排查以下点：

• 确认@types/node安装正确：项目本地node_modules下必须存在@types/node目录，且包的大版本和你本地运行的Node.js大版本匹配（例如使用Node 20则安装@types/node@20.x），不要仅在全局安装该类型包。
• 调整导入写法：纯JS风格的const fs = require('fs')在部分配置下不会触发TS的模块类型推导，require会被识别为返回any的普通函数。替换为TS原生支持的CommonJS写法import fs = require('fs')，或ES模块写法import * as fs from 'fs'即可正常拿到类型。
• 检查文件与运行参数：确认index.ts顶部没有添加// @ts-nocheck注释，也没有被tsconfig的exclude规则排除；如果使用ts-node运行，不要添加--transpile-only参数，该参数会跳过类型检查流程，所有未显式标注类型的变量都会被识别为any。

修复后可用的tsconfig参考 #

{
  "ts-node": {
    "cwd": "/Users/georgenorris/Code/take-homes/simple-chat",
    "projectSearchDir": "/Users/georgenorris/Code/take-homes/simple-chat"
  },
  "compilerOptions": {
    "lib": ["es2021"],
    "module": "commonjs",
    "moduleResolution": "node",
    "target": "es2021",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "types": ["node"],
    "sourceMap": true,
    "inlineSourceMap": false,
    "inlineSources": true,
    "declaration": false,
    "noEmit": false,
    "outDir": "./.ts-node"
  }
}

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