必须安装Tabnine Ltd.官方插件，重启VSCode并登录账户，启用本地模型且Mac用户需用Rosetta运行，状态栏显示绿色9图标才表示就绪。
Tabnine 插件必须从 VS Code 官方扩展市场安装，且只认准作者为 Tabnine Ltd. 的那个 —— 其他同名插件（比如 TabNine Pro、Tabnine++ 或作者是个人账号的）都不可靠，尤其在低配机器上容易引发模型加载失败、静默上传代码、签名失效等问题。
认准官方插件，别被搜索结果带偏
打开 VS Code，按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）进入扩展面板，在搜索框输入 Tabnine。你会看到多个结果，但只有这一项是合法的：
- 名称："Tabnine AI Autocomplete"
- 作者栏明确写着 "Tabnine Ltd."
- 图标是紫色的数字 "9"
其他所有带“Pro”“++”“Enhanced”字样的、作者不是 Tabnine Ltd. 的，一律跳过。
装完必须重启 VS Code
点击“Install”，等待右下角状态栏出现紫色 9 图标（绿色表示就绪，灰色表示未加载成功）。但这还不够：
- 低配机器（如 8GB 内存 + i5-8250U）常因 LSP 初始化未完成导致后续补全卡死或不响应
- 不重启，TabNine 语言服务进程可能根本没起来，状态栏图标会一直灰着
- 重启后若仍不显示绿色图标，打开输出面板（Ctrl+Shift+U），切换到 TabNine 日志页，查是否有 Failed to start backend 或 model not found
首次使用要登录，否则补全不生效
安装并重启后，VS Code 通常会自动弹出登录窗口；没弹？手动点状态栏的 9 图标，或执行命令面板（Ctrl+Shift+P）→ 输入 Tabnine: Open Settings → 点右上角登录按钮。
- 免费版也必须注册并登录，否则 tabnine://login 会静默失败，补全始终不触发
- 登录后状态栏应显示 Tabnine Local（启用本地模型时）或 Tabnine Cloud（默认云端模式）
- 如果图标仍是灰色，大概率是账户没登、模型没下载完、或被安全软件拦截了本地服务端口（127.0.0.1:8080）
本地模型不是设个配置就完事
想用本地模型提速、断网可用、不传代码？光在 settings.json 里加 "tabnine.experimentalLocalModel": true 没用：
- 必须先升级插件到 v4.20+（旧版根本不打包 arm64/x86_64 双架构模型）
- 在设置界面切 Model Type 为 Local 后，要主动点右下角弹出的 Download local model 按钮
- M1/M2 Mac 用户必须让 VS Code 用 Rosetta 运行（右键应用 → 显示简介 → 勾选“使用 Rosetta 打开”），否则会报 bad CPU type in executable
- 下载完成后，去缓存目录确认模型文件存在：
• macOS/Linux：~/.tabnine/，找 model-*.bin（大小 >20MB）
• Windows：%LOCALAPPDATA%\TabNine\
真正卡住人的从来不是“怎么装”，而是装错版本、没重启、没登录、或以为开了配置就等于模型跑起来了。状态栏那个紫色 9 图标，绿色才代表一切就绪；灰色或没出现，说明某一步已经断在半路了。
