VSCode 的 IntelliSense 需结合语言服务、扩展和项目配置才能高效工作。需启用对应语言服务器、安装推荐扩展、正确设置语言模式，配置 jsconfig.json 或 tsconfig.json 以支持跨文件导入与路径别名，并通过设置优化补全行为与性能。
VSCode 的 IntelliSense 不是开箱即用就“全知全能”的，它需要结合语言服务、扩展和项目配置才能发挥真正价值。核心在于让编辑器准确理解你的代码上下文——类型、导入路径、依赖版本、甚至自定义模块结构。
确保语言服务已正确启用
IntelliSense 依赖对应语言的 Language Server（如 TypeScript 的 tsserver、Python 的 Pylance、JavaScript 的 TypeScript SDK）。没有活跃的语言服务，补全、跳转、悬停提示都会失效。
- 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入 Developer: Toggle Developer Tools，查看 Console 是否有语言服务器启动失败或崩溃报错
- 确认已安装官方推荐扩展：TypeScript/JavaScript 用内置支持（无需额外安装），Python 推荐 Pylance，C/C++ 用 C/C++ 扩展包，Go 用 Go 扩展
- 在文件右下角检查当前语言模式是否正确（例如 .ts 文件应显示 TypeScript，不是 Plain Text）
配置 jsconfig.json 或 tsconfig.json（JS/TS 项目关键）
没有配置文件，VSCode 默认以单文件为单位做类型推导，无法识别跨文件导入、路径别名（如 @/components）、或自定义类型声明。
- 在项目根目录创建 jsconfig.json（纯 JS）或 tsconfig.json（TS），至少包含 "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } }
- 确保 "include" 字段覆盖源码目录（如 ["src/**/*"]），否则部分文件不会被语言服务索引
- 修改配置后，执行命令 Typescript: Restart TS server（通过 Ctrl+Shift+P 调出）立即生效
调整 IntelliSense 行为与性能选项
默认行为可能不符合习惯，或在大型项目中变慢。可通过设置精细控制补全来源、触发时机和响应速度。
- 禁用无关补全源：关闭 editor.suggest.showKeywords（避免补全 if/for 等关键字），或关闭 editor.suggest.showSnippets（减少代码片段干扰）
- 提升响应速度：开启 typescript.preferences.includePackageJsonAutoImports 设为 "auto"，加快 node_modules 类型加载；对大项目可设 "typescript.preferences.useLabelDetailsInCompletionEntries" 为 false 减少渲染开销
- 补全更精准：启用 editor.suggest.filterSuggestsByPrefix（只匹配开头字符），并设 editor.suggestSelection 为 "recentlyUsedByPrefix"
处理常见失效场景
即使配置正确，某些情况仍会“失灵”，多数源于路径、声明或缓存问题。
- 导入路径红色波浪线但能运行：检查 jsconfig.json 中 paths 和 baseUrl 是否匹配实际目录结构，注意斜杠方向和通配符写法
- 第三方库无提示：确认已安装对应 @types/xxx（如 @types/react），或库本身含内置类型（现代库如 Vitest、Zod 通常自带）
- 修改代码后提示未更新：尝试保存文件（触发自动重分析），或手动运行 Developer: Restart Extension Host
基本上就这些。IntelliSense 的强大不在于堆砌功能，而在于让语言服务“读懂”你的项目结构。配置一次，后续编码效率提升是持续且明显的。
