VSCode自动导入完整使用教程-VSCode-PHP中文网

VSCode自动导入需语言服务驱动，核心条件为：右下角显示正确语言模式（如TypeScript/Pylance）、存在tsconfig.json或jsconfig.json、settings中python.analysis.autoImportCompletions等四项配置均为布尔true、禁用冲突插件，且须用Ctrl+.触发而非回车。

vscode自动导入完整使用教程

VSCode 的自动导入不是“开箱即用”的功能，它必须依赖正确的语言服务器、配置项和项目结构才能生效。没提示、Ctrl+. 没反应、输完回车只留名字——这些都不是插件没装好，而是底层条件没满足。

确认语言服务器正在运行且被正确识别

自动导入的第一道门槛是语言服务是否真正加载。VSCode 右下角状态栏显示的不是“Python”或“TypeScript”，而是“Python (Jedi)”“TypeScript (Deprecated)”或“Plain Text”，那补全逻辑根本不会启动。

点击右下角语言模式（如“Python”），手动切换为 Python (Pylance) 或 TypeScript（带齿轮图标）
打开命令面板（Ctrl+Shift+P），运行 Developer: Toggle Developer Tools，在 Console 中输入 require('typescript') —— 若报 Cannot find module 'typescript'，说明 TS 服务未加载
Python 用户需检查设置中 python.languageServer 是否设为 "Pylance"（字符串，带双引号），而非 "Default" 或 "Jedi"
TS/JS 项目必须在根目录有 tsconfig.json 或 jsconfig.json，哪怕内容只是 {"compilerOptions": {}}

关键配置项必须显式启用（settings.json 最可靠）

UI 界面里勾选“Auto Import Completions”经常不生效，因为底层 JSON 值没写对。布尔值写成字符串 "true"、漏掉 editor.quickSuggestions.other、或被其他插件覆盖，都会导致自动导入静默失败。

打开 settings.json（快捷键 Ctrl+, → 右上角“打开设置(JSON)”）

确保包含以下四行（注意：无引号包裹 true，other 必须为 true）：

{
  "python.analysis.autoImportCompletions": true,
  "editor.quickSuggestions": {"other": true},
  "javascript.suggest.autoImports": true,
  "typescript.suggest.autoImports": true
}

禁用可能劫持补全的插件，如旧版 Auto Import (wix)、ES7+ React/Redux snippets —— 它们会把 Ctrl+Space 绑定到代码片段，而不是 import 补全

触发方式只有两种真正稳定

别等输完回车——那只会插入标识符名，不会加 import。自动导入不是“预测输入”，而是“语义修复”。

VSCode

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

下载

光标停在未定义符号末尾，按 Ctrl+.（Windows/Linux）或 Cmd+.（Mac），弹出 Quick Fix 菜单，选 “Import … from …”
输入前几个字母（如 datetim），按 Ctrl+Space 唤起 IntelliSense，从带灯泡图标的选项里选 —— 注意：不是普通下拉项，是左侧带?的那条
本地模块（如 utils.py）必须在当前工作区根目录下，且不能藏在未打开的子文件夹里，否则 Pylance 索引不到
路径别名（如 @/hooks）必须在 tsconfig.json 的 baseUrl 和 paths 中声明，VSCode 不读 Webpack/Vite 配置

保存时自动整理 import 是另一回事

editor.codeActionsOnSave 控制的是保存时的行为，和输入时的自动导入无关。它只负责删未用项、排序、合并重复 import，但不会补新 import。

若想保存时自动增删 import，加这一行到 settings.json：
```
"editor.codeActionsOnSave": {"source.organizeImports": true}
```
该配置对 Python 无效，仅适用于 TypeScript/JavaScript
它不解决“为什么 Ctrl+. 不弹窗”的问题——那是语言服务或配置没到位，不是保存逻辑的问题

最常被忽略的一点：Pylance 的索引需要时间。右下角显示“分析中…”时，所有自动导入都处于禁用状态；等它消失后，再试。很多用户在索引完成前反复重启、重装插件，其实只需多等 10 秒。