VSCode自动导入失效的根本原因是语言服务未加载或项目结构未被识别；需先确认右下角语言模式正确、重启对应语言服务器、确保tsconfig.json/jsconfig.json存在且路径配置有效，并验证autoImports等设置为布尔值true。
VSCode 自动导入报错，八成不是规则写错了，而是语言服务压根没认出你的项目结构或当前文件——改设置前先确认服务是否在跑、路径是否被解析、语言模式是否对得上。
为什么 Ctrl+. 没反应或不显示 import 选项
根本原因通常是语言服务器未加载或配置未生效，而不是 autoImports 开关没开。
-
typescript.suggest.autoImports和javascript.suggest.autoImports必须是布尔值true，写成"true"（字符串）就完全失效 - 右下角状态栏显示
Plain Text、JavaScript (Deprecated)或没有齿轮图标 → 说明语言模式错误或 TS/JS 服务崩溃 - 打开命令面板（
Ctrl+Shift+P），运行TypeScript: Restart TS server或Python: Restart Language Server，再试 - Vue 文件必须看到状态栏有
vue标识，且已执行Vue: Take Over and Restart，否则defineProps等不会触发自动导入
第三方库或别名路径导入失败（如 @/utils 报 Cannot find module）
VSCode 不读 Webpack/Vite 的 resolve.alias，只认 tsconfig.json 或 jsconfig.json 里的 baseUrl 和 paths。
- 项目根目录必须存在
tsconfig.json（哪怕内容只是{"compilerOptions": {}}） -
paths映射要和baseUrl配合，例如："@/*": ["src/*"]要求"baseUrl": "." - 改完配置后必须重启语言服务，否则缓存不刷新
- Python 同理：本地模块（如
utils.py）只有在工作区根目录下、且被 Pylance 成功索引后才可建议导入；子文件夹未打开，再配也白搭
保存时不整理 import（增删+排序）
editor.codeActionsOnSave 是独立开关，和补全时的 autoImports 无关，且只作用于当前文件。
- 需显式启用：
"editor.codeActionsOnSave": {"source.organizeImports": true} - 它不会跨文件扫描，也不会自动加 missing import，只整理已有 import 块（去重、排序、删未用项）
- Vue 单文件中该配置默认无效，除非 Volar 已接管且文件被正确识别为
vue模式 - 若保存后无反应，检查是否被其他扩展（如 ESLint 插件）的
codeActionsOnSave覆盖，优先级以最后加载者为准
Python 跨文件夹 import 报 ModuleNotFoundError 但运行正常
这是解释器路径和 Pylance 路径认知不一致导致的典型“编辑器红、终端绿”现象。
- 最稳方案：在项目根目录建
.env文件，写入PYTHONPATH=${workspaceFolder} - 次选：VS Code 工作区设置中加
"python.defaultInterpreterPath"和"python.envFile"指向该.env - 禁用 Jedi，确保
python.languageServer设为"Pylance"（字符串，带双引号） - 改完后关掉所有终端再重开，否则旧
sys.path缓存还在
真正卡住人的从来不是配置项怎么写，而是你改了 settings.json 却没重启语言服务，或者以为 jsconfig.json 放在子目录里也能生效——路径解析和服务器状态，才是自动导入能否落地的硬门槛。
