先确认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)）。如果只看到函数签名没带括号外的模块来源，说明语言服务没识别到该符号的导出位置。
常见错误现象：
- 输入
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 配置是否真能被运行时解析——它只按配置生成路径，实际报错要等执行时才暴露。
