vscode 默认不自动插入 import 语句,主因是语言服务未激活、配置缺失或语言模式识别错误;需确认状态栏显示正确语言(如 typescript/python)、配置 tsconfig.json/jsconfig.json 或 python.languageserver、启用 autoimports 相关设置、用 ctrl+. 触发 quick fix,并确保路径别名在 tsconfig.json 中配置且 ts server 已重启。

VSCode 默认不自动插入 import 语句,不是插件没装,而是语言服务未激活、配置缺失或语言模式识别错误——绝大多数“输完回车没反应”的问题都卡在这三步上。
确认语言服务已加载且文件被正确识别
右下角状态栏必须显示 TypeScript、JavaScript 或 Python(带齿轮图标),不能是 Plain Text、HTML 或 Vue (Deprecated)。否则补全逻辑根本不会启动。
- 若显示异常:按
Ctrl+Shift+P→ 运行Developer: Toggle Developer Tools→ 切到 Console 标签页,输入require('typescript');报Cannot find module 'typescript'说明 TS 服务未加载 - 项目根目录必须存在
tsconfig.json(TS)或jsconfig.json(JS),哪怕内容只是{"compilerOptions": {}} - Python 项目需确保
python.languageServer设为"Pylance"(字符串,带双引号),且状态栏显示Python (Pylance),不是Python (Jedi)
开启 autoImports 设置(关键开关)
这两个布尔值控制「输入时是否在补全列表里显示带 import 前缀的建议项」,默认是 false,新装 VSCode 或重置设置后极易遗漏。
- 打开
settings.json(Ctrl+,→ 右上角“打开设置(JSON)”) - 必须加入这两行(注意拼写是
autoImports,复数,大小写敏感):"typescript.suggest.autoImports": true"javascript.suggest.autoImports": true - Python 用户还需加:
"python.analysis.autoImportCompletions": true"editor.quickSuggestions.other": true
用 Ctrl+. 触发 Quick Fix,别依赖输完回车
输入 useState 后直接回车,大概率只插入名字,不加 import。真正稳定的是主动调用快速修复。
- 光标停在未导入符号末尾(如
np.array|),按Ctrl+.(Windows/Linux)或Cmd+.(Mac) - 从弹出菜单中选
Import 'array' from 'numpy'类选项 - 对本地模块(如
utils.py)生效的前提:该文件在当前工作区根目录下,且路径可被 Pylance / TS Server 索引到(不能放在未打开的子文件夹里)
路径别名(如 @/hooks)不生效?只认 tsconfig.json
VSCode 完全不读 Webpack/Vite 的 resolve.alias,它只认 tsconfig.json 中的 baseUrl 和 paths。
- 在
tsconfig.json的compilerOptions中显式配置:"baseUrl": "./","paths": { "@/*": ["src/*"] } - 改完后必须运行命令面板中的
TypeScript: Restart TS server - 确保当前文件在
include范围内(如"include": ["src/**/*"]),否则对应路径无法解析
最常被忽略的一点:多个根工作区下,只有「活动文件夹」下的 tsconfig.json 和 settings.json 生效;其他子项目要单独配,或用 "extends" 继承主配置。











