IntelliCode 智能补全未生效需依次安装扩展、验证语言服务、配置模型偏好、强制触发建议并排查加载失败问题。
如果您在使用 VSCode 编写代码时发现自动补全建议不够精准、缺乏上下文感知能力，或无法根据项目风格生成符合习惯的代码片段，则可能是 IntelliCode 扩展未启用、模型未加载完成或配置未适配当前语言环境。以下是启用并优化 IntelliCode 智能补全功能的具体操作步骤：
本文运行环境：MacBook Air M2，macOS Sequoia。
IntelliCode 功能依赖于 Visual Studio IntelliCode 官方扩展，必须通过 VSCode 扩展市场安装并手动启用，否则语言服务器不会加载 AI 模型支持。
1、启动 VSCode，点击左侧活动栏中的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入 IntelliCode，找到由 Microsoft 发布的官方扩展，名称为“Visual Studio IntelliCode”。
3、点击“安装”按钮，等待安装完成，随后点击“重新加载”使扩展生效。
IntelliCode 仅对特定语言提供 AI 增强补全，需确认当前打开的文件类型已被支持，且对应的语言服务器（如 Python 的 Pylance、TypeScript 的 TypeScript Server）已启用 IntelliCode 集成。
1、打开一个 .py 文件，观察右下角状态栏是否显示 Pylance (IntelliCode)。
2、若显示为“Pylance”但无括号内标注，说明 IntelliCode 未接管该语言服务，需检查设置中是否禁用了相关功能。
3、按下 Cmd+,（Mac）打开设置，在搜索框中输入 intellisense suggestion，确保“Editor: Suggest Show Classes”和“Editor: Suggest Show Functions”均处于启用状态。
IntelliCode 默认使用通用模型，但可通过配置优先加载针对当前项目训练的自定义模型或团队共享模型，从而提升补全准确率。
1、在 VSCode 中按下 Cmd+Shift+P 打开命令面板，输入并选择 IntelliCode: Configure IntelliCode Model。
2、在弹出选项中选择目标语言（如 TypeScript），再选择模型类型：Team model 或 Project-specific model（若已存在）。
3、确认后，VSCode 将在工作区根目录生成 .vscode/intellicode.json 文件，并开始下载对应模型缓存。
IntelliCode 补全默认与标准 IntelliSense 合并呈现，但在某些场景下可能被低优先级建议掩盖，需通过快捷键主动调用高置信度 AI 推荐。
1、在编辑器中输
入部分变量名或函数前缀（例如 arr.）。
2、按下 Ctrl+Space（Mac）唤出补全列表，观察顶部是否出现带 AI 标识的建议项。
3、若未出现，可尝试连续两次按下 Ctrl+Space，触发 IntelliCode 专用建议模式。
当 IntelliCode 图标在状态栏显示为灰色或提示“Model not loaded”，通常表示本地模型文件损坏、网络受限导致下载中断，或 VSCode 版本不兼容。
1、点击状态栏右侧 IntelliCode 图标，查看弹出提示中的具体错误信息。
2、若提示 Failed to download model，检查系统代理设置是否拦截了 https://marketplace.visualstudio.com 域名请求。
3、手动清除模型缓存：前往 ~/Library/Caches/VisualStudioCode/Cache/Intellicode/，删除其中全部子目录后重启 VSCode。
# python
# vscode
# js
# json
# typescript
# macbook
# mac
# ai
# macos
