Tabnine本地模式真正启用需满足四条件：模型文件已下载并加载成功、VSCode架构匹配（M1/M2需Rosetta）、插件版本≥v4.20、语言服务器（LSP）正常运行；缺一不可。
Tabnine 本地模型能真正离线运行，但“无需联网”只在首次启用后成立——初始下载模型、验证签名、加载语言服务器仍需一次联网。
Tabnine Local 模式怎么才算真正启用
状态栏右下角出现 Tabnine Local 字样只是表象，关键要看模型是否完成加载。常见假成功现象：图标变绿但补全无响应、输入后延迟 3 秒以上、Tabnine: Show Suggestions 手动触发仍空白。
- 打开 VSCode 输出面板（
Ctrl+Shift+U），切换到TabNine日志页，重点查找Local model is ready或Loaded model from路径信息 - 若看到
Failed to download model或model not found in cache，说明本地模型根本没落盘，此时即使设了"tabnine.experimentalLocalModel": true也无效 - M1/M2 Mac 用户需确认 Rosetta 已启用：VSCode 必须以 x86_64 架构运行，否则本地模型进程启动失败（日志中会出现
exec format error）
settings.json 里加 "tabnine.experimentalLocalModel": true 为什么没用
这个配置项只是开关，不负责模型分发。它生效的前提是 Tabnine 插件已内置对应架构的本地模型二进制，而目前仅较新版本（v4.20+）才默认打包 x86_64 和 arm64 双架构模型。
- 检查插件版本：在扩展面板中找到 Tabnine，点「详细信息」看版本号；低于 v4.20 的必须先升级，旧版设了该字段也只会 fallback 到云端
- 手动触发模型下载：执行命令面板
Tabnine: Open Settings→ 切换Model Type为Local→ 点击右下角弹出的Download local model按钮（不是设置保存就完事） - 模型缓存路径因系统而异：
~/.tabnine/（macOS/Linux）或%LOCALAPPDATA%\TabNine\（Windows），可进该目录确认是否有model-*.bin文件且大小 >20MB
离线后补全质量断崖下跌？别怪模型，先查语言服务器
Tabnine 本地模式 ≠ 全功能离线。它依赖外部语言服务器（LSP）提供语法树和符号定义，否则只能做纯文本级补全，比如 df. 后不会提示 pandas.DataFrame 方法。
- Python 必须有
pylsp或python-language-server在 PATH 中，且TabNine.toml里配了[language.python] command = "pylsp" - TypeScript 需确保工作区含
node_modules/typescript，否则tsserver启动失败，TSX 文件里属性补全直接消失 - Go 用户注意：
gopls默认监听localhost:0（随机端口），但 Tabnine 本地模型会尝试直连127.0.0.1:3000，得在TabNine.toml显式写port = 0并设useStdio = true
为什么注释、字符串、正则里完全不补全
这不是 bug，是设计限制。Tabnine 主动跳过所有字符串字面量（""、''、``）、注释块（//、/* */）和正则字面量（/.../）内部区域，因为这些上下文噪声太大，模型无法可靠推断意图。
- 别试图用
tabnine.experimental.enableInStrings这类不存在的配置项去绕过——它根本不在官方 schema 里 - 若你在 JSX 属性值里写
className="mt-|"想补全 Tailwind 类名，得靠tailwindcss-intellisense插件，Tabnine 不处理 CSS 类建议 - 想让 TODO 注释带自动编号或日期，用
todo-tree或自定义代码片段，不是 Tabnine 的职责范围
真正离线可用的边界很清晰：模型文件已下载、LSP 可启动、文件类型被正确识别、不碰字符串和注释——漏掉任意一环，都会让你以为“本地模式失效”，其实只是你没给它凑齐离线运行的全部零件。
