寻求重构TypeScript代码时自动化整理导入语句的方法

我经常在重构TypeScript项目时遇到和你一样的问题——复制粘贴大量代码后，要么一堆未使用的导入占着地方，要么到处都是找不到依赖的红色报错。下面是几个我亲测好用的解决方案，从编辑器快速操作到项目级批量处理都有：

编辑器端快速搞定（以VS Code为例） #

如果你只是处理单个或少数几个文件，用VS Code的内置功能最方便：

• 手动批量操作：
  1. 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）打开命令面板
  2. 搜索并执行 Add Missing Imports：它会自动扫描当前文件里所有未导入的依赖，一次性补全所有缺失的导入语句
  3. 接着再执行 Organize Imports：这个命令会立刻移除所有没被用到的导入，还能帮你把导入按规范排序，一举两得
• 自动触发（重构时更省心）：
  要是你不想每次都手动点，可以在VS Code的settings.json里加一段配置，让它每次保存文件时自动完成这两步：

  "editor.codeActionsOnSave": {
    "source.addMissingImports": true,
    "source.organizeImports": true
  }
  

  要是只想让这个规则对TS文件生效，就把配置包在[typescript]里：

  "[typescript]": {
    "editor.codeActionsOnSave": {
      "source.addMissingImports": true,
      "source.organizeImports": true
    }
  }
  

项目级批量处理（CLI工具） #

如果需要一次性处理整个项目的所有TS文件，用CLI工具效率更高：

步骤1：补全缺失导入 #

可以用ts-auto-import这个专门的工具，它能扫描整个项目的TS文件，批量补全所有缺失的导入：
首先全局安装：

npm install -g ts-auto-import

然后在项目根目录运行（记得先确保有tsconfig.json）：

ts-auto-import --project ./tsconfig.json src/**/*.ts

步骤2：移除冗余导入 #

配合ESLint的TypeScript插件，就能批量移除所有未使用的导入：

1. 先安装依赖：

npm install --save-dev eslint @typescript-eslint/eslint-plugin @typescript-eslint/parser

2. 在项目根目录创建.eslintrc.json，添加相关规则：

{
  "parser": "@typescript-eslint/parser",
  "plugins": ["@typescript-eslint"],
  "rules": {
    "@typescript-eslint/no-unused-imports": "error",
    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
  }
}

3. 执行批量修复命令：

eslint --fix src/**/*.ts

一些小提示 #

• 确保你的tsconfig.json里compilerOptions的moduleResolution设置为node或nodenext，这样工具才能正确找到第三方库的类型定义，避免补全出错
• 少数复杂场景（比如命名冲突、类型和值导入混淆）可能需要手动微调，工具处理完后建议扫一眼关键文件，确保导入符合预期

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