VSCode无一键清理按钮，最稳方案是保存时自动清理：需正确配置"editor.codeActionsOnSave": {"source.organizeImports": true}，而非误配格式化或依赖插件；Python需借助pylint提示+脚本处理，原生不支持自动organize imports。
VSCode 本身没有“一键清理”按钮，但保存时自动删未用 import 是开箱即用的功能——前提是正确启用 source.organizeImports，而不是误配成格式化或依赖 ESLint。
为什么 Ctrl+Shift+P 搜 “organize imports” 没反应？
这个命令 editor.action.organizeImports 在很多文件里默认不触发，不是插件坏了，而是语言服务没接上：
- 右下角状态栏显示的是
Plain Text而不是JavaScript、TypeScript或Python—— 说明 VSCode 没识别当前文件类型 - 文件还没保存（
untitled-1），VSCode 不会对临时文件执行代码操作 - .js 文件缺少
jsconfig.json，.ts 文件没配好tsconfig.json，TypeScript 语言服务无法启动 - Python 文件装了 Pylance 但没启用 linting，或者根本没装
pylint，此时连未用提示都看不到
验证方式：打开一个已保存的 .ts 文件，删掉一个正在用的 import，再手动输一遍，看是否出现灯泡图标 → 按 Ctrl+. 是否弹出 Organize imports。能弹出，说明语言服务正常；不能，先修文件类型和配置。
保存时自动清理的最小可靠配置
别在 UI 设置里只勾选 “Format on save”，那只会调用 Prettier 或 ESLint，对 import 无感。必须直接改 settings.json：
"editor.codeActionsOnSave": {
"source.organizeImports": true
}注意："editor.codeActionsOnSave": true 是无效写法；也不能写成数组或布尔值，必须是对象且键名完全匹配。
- 该配置在
.ts/.tsx中由 TypeScript 服务驱动，识别准、误删少 - 在
.js/.jsx中效果打折，需靠 JSDoc 注解（如/** @type {import('./utils').foo} */）辅助判断 - Vue 单文件组件（
.vue）需安装 Volar 并确保typescript.suggest.autoImports开启，否则<script setup>里的导入不会被组织
和 ESLint / Prettier 共存时容易踩的坑
如果同时开了 "source.fixAll.eslint": true 和 "source.organizeImports": true，ESLint 可能先跑一遍修复，把 import 排序/补全，然后 TypeScript 再删一次——结果删过头，或删一半又加回来。
- 现象：保存后 import 顺序乱了、重复引入还在、甚至删掉了本该保留的命名空间导入（如
import * as d3 from 'd3'） - 推荐做法：先关掉
source.fixAll.eslint，只留source.organizeImports；若必须共存，把 ESLint 的unused-imports/no-unused-imports设为error，配合eslint.run: onType实时提示，比强删更可控 - 确认 ESLint 插件版本 ≥ 2.4.0，旧版会忽略
source.organizeImports的执行时机
Python 文件怎么处理？
VSCode 原生不支持 Python 的 source.organizeImports，Pylance 只能灰色标出未用导入，但不会响应 Ctrl+. 或自动删。
- 装
pylint：pip install pylint，并在设置中启用："python.linting.enabled": true+"python.linting.pylintEnabled": true - 问题会标为
W0611 (unused-import)，但 VSCode 不自动修复——你得手动删，或用脚本调autopep8 --in-place --aggressive或black --skip-string-normalization - 想自动排序 import？配
isort："python.sortImports.args": ["--profile", "black"]，再配合"editor.codeActionsOnSave": { "source.organizeImports": true }（仅触发排序，不删未用）
真正难的不是配置，是语言服务能否准确判定“未使用”——比如动态 import、webpack require.context、或运行时反射调用，所有这些都会让自动清理失效。这时候得靠人眼扫一眼 import 后有没有实际引用，而不是无脑相信保存就干净了。
