VSCode保存时自动整理import的核心是启用语言服务的代码操作能力：TS/JS用source.organizeImports，Python用isort，ESLint的import/order仅排序不删未用项。
保存时自动整理 import 语句，核心不是“格式化”，而是启用语言服务的代码操作能力——TypeScript/JavaScript 靠 source.organizeImports，Python 靠 isort，ESLint 的 import/order 只能排序但不删未用项。
为什么 Ctrl+Shift+P 搜 “organize imports” 没反应
这个命令 editor.action.organizeImports 不是随时可用的，它依赖语言服务就位：
- 右下角状态栏显示的是
Plain Text而不是TypeScript、JavaScript或Python→ 文件类型没识别，语言服务根本没启动 - 文件是
untitled-1（未保存），VSCode 不会对临时文件执行任何代码操作 - .ts 文件缺少有效的
tsconfig.json，或 .js 文件没配jsconfig.json→ TypeScript Server 启动失败，组织 import 功能失效 - Python 文件装了 Pylance 但没启用 linting，或压根没装
pylint→ 连“未使用 import”都标不出，更别说自动清理
验证方式：打开一个已保存的 .ts 文件，删掉一个正在用的 import，再手动输入一遍，看是否出现灯泡图标 → 按 Ctrl+. 是否弹出 Organize imports。能弹出，说明服务正常；不能，先修文件类型和配置。
TS/JS 项目：最小可靠配置是 "source.organizeImports": true
这不是格式化行为，而是由 TypeScript 语言服务驱动的语义级操作，识别准、误删少：
- 必须直接改
settings.json，写成："editor.codeActionsOnSave": { "source.organizeImports": true }——"editor.codeActionsOnSave": true是无效写法；也不能写成数组或布尔值 - 在
.ts/.tsx中效果最好；.js/.jsx中需靠 JSDoc 注解（如/** @type {import('./utils').foo} */）辅助判断导入用途 -
.vue单文件组件需安装Volar，且确保typescript.suggest.autoImports开启，否则<script setup></script>里的导入不会被组织 - 别和 ESLint 的
source.fixAll.eslint共存：两者先后触发可能删过头，或把import * as d3 from 'd3'这类命名空间导入也干掉
Python 项目：必须用 isort，organizeImports 原生不支持
VSCode 的 Python 扩展默认不调 isort，必须显式指定它为格式化器：
- 安装
isort5.12+：pip install isort - 项目根目录放
pyproject.toml，写入：[tool.isort]\nforce_sort_within_sections = true\nlines_after_imports = 2
—— 关掉 PEP 8 分组逻辑，才能实现全局字母序 -
settings.json中设："python.formatting.provider": "isort",\n"editor.formatOnSave": true
- 禁用所有其他格式化配置（如
python.formatting.blackArgs），否则isort会被绕过 - 右下角语言模式必须是
Python，不是Plain Text，否则 VSCode 根本不走 Python 格式链路
想按字母顺序严格排序？别指望 organizeImports，得靠 ESLint + import/order
source.organizeImports 只删未用项、分组、加空行，不控制字母序。真要升序排，必须走 ESLint 修复流：
- 本地安装
eslint-plugin-import（全局安装无效） -
.eslintrc.js或eslint.config.mjs中启用："import/order": ["error", { "alphabetize": { "order": "asc", "caseInsensitive": true } }] -
settings.json中启用："editor.codeActionsOnSave": { "source.fixAll.eslint": true }—— 注意不是source.organizeImports - 检查
eslint.validate是否包含当前文件类型（比如typescriptreact必须显式列出），否则规则根本没加载 - 别把规则设成
"warn"，否则保存时不触发修复；也别只配规则不打开source.fixAll.eslint
最常被忽略的一点：所有这些功能都依赖语言服务实时解析，而解析结果又高度依赖 tsconfig.json、jsconfig.json 或 pyproject.toml 的路径配置是否正确——路径错一格，整个 import 整理链就断在第一步。
