vscode保存时自动组织import必须配置"editor.codeactionsonsave": {"source.organizeimports": true}，仅开formatonsave或ui开关无效；该功能依赖语言服务，ts/jsx/vue（需volar）支持较好，python须用isort并设"python.formatting.provider": "isort"。
VSCode保存时自动组织import必须配editor.codeActionsOnSave对象
只开editor.formatOnSave或勾选UI里的“Organize imports on save”开关，完全不生效。这个动作不是格式化的一部分，而是VSCode原生的代码操作（Code Action），必须显式写成对象形式：
-
"editor.codeActionsOnSave": { "source.organizeImports": true }—— 同时排序 + 删除未使用项（.ts/.tsx稳定；.js需JSDoc辅助） -
"editor.codeActionsOnSave": { "source.removeUnusedImports": true }—— 只删不用的import，不重排顺序（适合对顺序敏感的团队） - 两个可以共存：
"source.organizeImports": true, "source.removeUnusedImports": true - 别写成布尔值：
"editor.codeActionsOnSave": true是无效配置
source.organizeImports在不同语言里效果天差地别
它不是通用功能，背后依赖语言服务，各语言支持程度差异极大：
-
.ts/.tsx：由TypeScript语言服务驱动，识别准、删除稳，比如import { ref } from 'vue'没调用就直接删 -
.js/.jsx：无类型信息时极保守，import { foo } from './utils'但没显式用foo，大概率跳过删除；加JSDoc注解（如/** @type {string} */）或类型导入能提升识别率 -
.vue（SFC）：必须装Volar插件，且确保typescript.suggest.autoImports开启，否则<script setup></script>里的import不响应 -
.py：VSCode原生不支持source.organizeImports；Pylance仅灰显提示，不触发删除；得靠isort+autopep8脚本化处理
和ESLint共存时source.fixAll.eslint大概率导致import反复增删
常见现象：保存后import被删了一半，又自动加回来；或排序了但没删——本质是多个code action执行顺序冲突。
- 如果同时开了
"source.fixAll.eslint": true和"source.organizeImports": true，ESLint的修复可能在organize之后跑，尤其启用了eslint-plugin-import的auto-import规则时，会把刚删掉的import又补上 - 更稳妥的做法：先关掉
source.fixAll.eslint，只留source.organizeImports - 如必须共存，建议把
unused-imports/no-unused-imports设为error，配合eslint.run: onType实时提示，比强删更可控 - 验证是否生效：手动删一个已使用的import → 保存 → 看是否弹出灯泡提示 → 按
Ctrl+.能否看到“Organize imports”选项
Python想排序import只能靠isort，且必须指定python.formatting.provider
VSCode原生不提供Python的source.organizeImports支持，python.sortImports.args等旧配置已废弃（1.20+版Python扩展停用该命令）。
- 安装
isort：pip install isort（推荐5.12+，支持--profile black） - 在
settings.json中显式指定："python.formatting.provider": "isort" - 禁用冲突项：
"python.formatting.autopep8Args"、"python.formatting.blackArgs"清空，避免后台偷偷调用别的工具 - 项目根目录放
pyproject.toml，最小可用配置示例：[tool.isort] profile = "black" line_length = 88 known_first_party = ["myproject"]
- 注意：VSCode不读
setup.cfg，优先用pyproject.toml；若用.isort.cfg，必须UTF-8无BOM
真正容易被忽略的是语言服务状态——右下角显示“Plain Text”或“Py”而非“Python”，或者文件未保存为.py后缀，isort和source.organizeImports都会静默失效。确认前先看状态栏。
