如何自动清理TypeScript项目中已废弃的@types/包？

1. 保留过时@types包是否会误导TypeScript及IDE？ #

大概率会引发问题。TypeScript解析类型时会优先读取@types/*包中的定义，若主包已内置更新的类型，旧@types包会与主包类型产生冲突：

• 主包新增的API可能无对应类型提示，或触发不必要的类型报错；
• 同一个模块存在两份类型定义时，TS可能出现编译错误或智能提示混乱；
• 过时@types包包含的废弃类型，会让IDE给出错误的代码引导。

2. 自动列出或清理废弃@types包的方法 #

工具方案 #

• depcheck：一款依赖检测工具，可扫描项目中未被使用的依赖（包括@types包），执行命令：

  npx depcheck
  

  输出结果会标注未使用的@types包，可批量卸载。
• ts-prune：专门针对TypeScript项目检测未引用的类型依赖，执行命令：

  npx ts-prune
  

  它会精准列出项目中未被用到的@types包，方便定向清理。

自定义脚本方案 #

若需验证主包是否内置类型，可编写简单Node.js脚本自动筛选可卸载的@types包：

1. 保存以下代码为clean-types.js：

const fs = require('fs');
const path = require('path');

const pkg = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
const devDeps = pkg.devDependencies || {};
const typesPackages = Object.keys(devDeps).filter(key => key.startsWith('@types/'));

typesPackages.forEach(typePkg => {
  const mainPkg = typePkg.replace('@types/', '');
  const mainPkgPath = path.join('./node_modules', mainPkg, 'package.json');
  
  if (fs.existsSync(mainPkgPath)) {
    const mainPkgJson = JSON.parse(fs.readFileSync(mainPkgPath, 'utf8'));
    if (mainPkgJson.types || mainPkgJson.typings) {
      console.log(`可安全卸载：${typePkg}（主包${mainPkg}已内置类型）`);
    }
  }
});

2. 执行脚本获取结果：

node clean-types.js

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