Angular16升级TypeScript至5.1.6遇TS2688：找不到node类型定义文件

问题分析 #

升级TypeScript到5.1.6后执行ng build --configuration development --watch出现TS2688错误，核心原因是TypeScript无法找到指定的node类型定义文件，可能由依赖版本不兼容、tsconfig路径配置错误或依赖未正确安装导致。

解决方案 #

1. 修正tsconfig.app.json中的typeRoots路径错误 #

你的tsconfig.app.json中typeRoots配置了相对路径../node_modules/@types，如果该文件位于项目根目录，这个路径会指向根目录的上级目录（不存在node_modules），导致TypeScript找不到@types/node。

修改tsconfig.app.json的typeRoots：

"typeRoots": [
  "./node_modules/@types"
]

2. 确保@types/node与TypeScript 5.1.6版本兼容 #

TypeScript 5.1对@types/node的版本有兼容性要求，执行以下命令安装适配的版本：

npm install @types/node@latest --save-dev

或指定TS5.1兼容的稳定版本：

npm install @types/node@20.10.0 --save-dev

3. 清理并重新安装依赖 #

可能存在依赖缓存或安装不完整的情况，执行以下步骤：

# 删除node_modules和锁文件
rm -rf node_modules package-lock.json
# 清理npm缓存
npm cache clean --force
# 重新安装依赖
npm install

4. 检查tsconfig中types配置的必要性（可选） #

如果你的Angular浏览器应用没有直接使用Node.js API，可以移除tsconfig.json和tsconfig.app.json中compilerOptions.types数组里的"node"项，避免不必要的类型依赖：

• tsconfig.json：

"types": []

• tsconfig.app.json：

"types": []

验证修复 #

执行原命令验证错误是否消失：

npm run build-watch

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