如何使用VSCode一键清理JS与TS开发中的未使用引用？

本文共计778个文字，预计阅读时间需要4分钟。

确保在保存文件时自动格式化代码，并配置以下设置：

在 settings.json 里加这段（注意是对象，不是布尔值）：

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

常见错误是只配了 editor.formatOnSave，结果格式变了、分号加了，但冗余 import 还在原地。这个动作不是格式化的一部分，而是 VSCode 原生的 Code Action，得手动开。

JS 和 TS 文件中删 import 的效果差异

source.organizeImports 在 .ts/.tsx 中由 TypeScript 语言服务驱动，识别准、删得稳；但在 .js/.jsx 中依赖 JS 语言服务 + JSDoc 或类型注解，容易漏删或不敢删。

• 比如 import { helper } from './lib'，如果文件里完全没用到 helper，TS 文件能果断删掉；JS 文件大概率留着不动
• 加一句 /** @type {typeof import('./lib').helper} */ 或 console.log(helper)，JS 文件才可能触发识别
• 不推荐在纯 JS 项目里强依赖这个功能，不如配合 ESLint 的 no-unused-vars + import/no-unused-modules 插件做检查

想连未使用变量一起删？小心语言限制

可以加 "source.removeUnusedVariables": true，但仅对 TypeScript/JavaScript 文件有效，且实际表现受语言服务稳定性影响。

它不是语法树级分析，而是基于当前打开文件的符号引用推断——比如变量在另一个未打开的文件里被用了，这里就可能误删。

• TS 文件中效果较好，尤其开启 strict 模式后类型信息完整
• JS 文件中若没写 JSDoc，或用了动态属性访问（如 obj[key]），常会漏判或错删
• 该选项不会作用于字符串拼接、eval、Function 构造函数等运行时行为，别指望它覆盖所有场景

为什么有时保存后 import 没变？排查这几点

不是配置没生效，就是环境卡住了。优先检查这几处：

• 确认当前文件后缀是 .ts 或 .tsx —— .js 文件默认不触发 source.organizeImports
• 看右下角语言模式是否为 “TypeScript” 或 “JavaScript”，不是“Plain Text”或“JSON”
• 终端里跑 code --status，检查 TypeScript Server 是否正常加载（状态栏出现“TS”图标且无报错）
• 禁用所有插件后重试，某些语言扩展（如 Volar、Svelte for VS Code）会接管代码操作逻辑，覆盖原生行为

最隐蔽的问题：工作区设置了 "editor.codeActionsOnSave" 但被用户级设置覆盖了，或者某个 .vscode/settings.json 里写了 false 覆盖了全局配置。