先确认TypeScript或JavaScript语言服务已启用：检查右下角语言模式是否为TS/JS而非Plain Text，确保项目根目录存在tsconfig.json或jsconfig.json，开启typescript.preferences.autoImportSuggestions和javascript.suggest.autoImports设置。

VSCode 里 import 没自动补全？先确认 TypeScript 或 JavaScript 的语言服务是否启用

VSCode 默认不会为所有文件类型激活智能导入，关键看当前打开的文件是否被识别为 TypeScript、JavaScript 或支持 ESM 模块语法的上下文。如果文件后缀是 .js 但项目有 tsconfig.json，或者没装对应插件，import 补全大概率不工作。

实操建议：

• 用 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入并运行 Developer: Toggle Developer Tools，在 Console 里搜 language client 或 tsserver，确认 TypeScript 语言服务器已启动
• 检查右下角状态栏：点击语言模式（如 “Plain Text”），手动切换为 TypeScript 或 JavaScript
• 确保工作区根目录存在 tsconfig.json（TS 项目）或 jsconfig.json（JS 项目），哪怕内容只是 {"compilerOptions":{},"include":["**/*.js"]}

自动导入不起作用？检查 typescript.preferences.autoImportSuggestions 和 javascript.suggest.autoImports

这两个设置分别控制 TS 和 JS 文件的自动导入提示是否显示。VSCode 1.84+ 版本默认开启，但如果你改过用户设置、用了远程开发、或设置了 "editor.suggest.showImports": false，它就会静默失效。

实操建议：

• 打开设置（Ctrl+,），搜索 autoImportSuggestions，确认 TypeScript > Preferences: Auto Import Suggestions 已勾选
• 同理搜索 javascript.suggest.autoImports，确保值为 true
• 如果用的是 PnP（Yarn Berry）或自定义模块解析（如 baseUrl + paths），必须在 tsconfig.json 中正确配置，否则即使设置开了，也找不到可导入项

输入函数名按 Tab 或 Enter 没自动加 import？试试 Ctrl+Space 触发完整补全列表

VSCode 的自动导入不是“输完就插”，而是依赖补全建议列表中出现带路径的选项（例如 useState (react)）。如果只看到函数签名没带括号外的模块来源，说明语言服务没识别到该符号的导出位置。

常见错误现象：

VSCode

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

下载

• 输入 useEffe 后按 Tab，只补全了函数名，没加 import { useEffect } from 'react';
• 补全列表里有 useEffect，但没有标注来源，点选后也不插入 import

原因和对策：

• 当前文件未被纳入 tsconfig.json 的 include 范围 → 把文件路径加进去，或改用 files
• 依赖包没安装或 node_modules 损坏 → 运行 npm install 或 yarn install，再重启 TS 服务（命令面板中运行 TypeScript: Restart TS server）
• 使用了非标准导出（如 export * from './xxx' 嵌套过深）→ 尝试在目标模块中加一层具名导出，比如 export { foo } from './lib'

想让 import 插入位置更干净？调整 typescript.preferences.importModuleSpecifier

自动导入时生成的路径形式（相对路径 / node_modules 名 / 别名）由这个设置决定。默认是 shortest，但容易导致混用 ../ 和包名，尤其在大型项目里会干扰代码一致性。

实操建议：

• 设为 relative：强制生成相对路径，适合中小型项目，避免别名配置出错
• 设为 non-relative：优先用包名（如 import { foo } from 'lodash'），适合严格分层或 monorepo 外部依赖
• 设为 project-relative：需配合 jsconfig.json 中的 baseUrl 使用，例如 "baseUrl": "src"，才能把 src/utils/helper 缩写成 utils/helper

注意：修改后需保存设置并重启语言服务，已有 import 不会自动重写，只影响新插入的语句。

复杂点在于，不同项目对路径风格有隐性约定，而 VSCode 不会校验你的 paths 配置是否真能被运行时解析——它只按配置生成路径，实际报错要等执行时才暴露。