VSCode怎么设置保存文件时自动整理导入语句-VSCode-PHP中文网

VSCode保存时自动整理import的核心是启用语言服务的代码操作能力：TS/JS用source.organizeImports，Python用isort，ESLint的import/order仅排序不删未用项。

vscode怎么设置保存文件时自动整理导入语句

保存时自动整理 import 语句，核心不是“格式化”，而是启用语言服务的代码操作能力——TypeScript/JavaScript 靠 source.organizeImports，Python 靠 isort，ESLint 的 import/order 只能排序但不删未用项。

这个命令 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。能弹出，说明服务正常；不能，先修文件类型和配置。

这不是格式化行为，而是由 TypeScript 语言服务驱动的语义级操作，识别准、误删少：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

必须直接改 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' 这类命名空间导入也干掉

VSCode 的 Python 扩展默认不调 isort，必须显式指定它为格式化器：

安装 isort 5.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

source.organizeImports 只删未用项、分组、加空行，不控制字母序。真要升序排，必须走 ESLint 修复流：

.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