离线安装代码自动补全插件关键在于让lsp和底层依赖真正运行：拖.vsix仅注册前端，需确保工作区已加载、vscode有焦点且非远程环境；版本须匹配code --version主版本号；arm mac需darwin-arm64包；离线启用须在有网机完整触发lsp下载后拷贝整个扩展目录并彻底重启。
离线安装代码自动补全插件，关键不是“装上就行”，而是让语言服务器（LSP）和底层依赖真正跑起来——拖进 .vsix 只是第一步，90% 的失败发生在后续激活环节。
拖拽 .vsix 到编辑区没反应？先过这三关
VSCode 对拖放有硬性前提，缺一不可：
- VSCode 必须已加载工作区（哪怕只是空文件夹），不能是纯启动页
- 窗口要有系统焦点（任务栏图标高亮），且不能全屏、不能在远程桌面（RDP/TeamViewer）中
- 拖的是原始未解压的
.vsix文件，不是重命名过的.zip或解压后的文件夹；可用unzip -l xxx.vsix确认顶层含extension/目录
code --install-extension 报 “not compatible” 怎么快速修
这不是网络问题，是版本或架构错配。实操步骤：
- 运行
code --version，取第一段（如1.90.2→ 主版本为1.90） - 用
unzip -p xxx.vsix extension/package.json | grep engines查插件要求的"vscode": "^1.85.0" - 本地版本必须 ≥ 插件最低要求；若不匹配，降级下载对应
.vsix（比如 VSCode 1.84 就别硬装 Volar 1.14） - macOS ARM 要找带
darwin-arm64标识的包，x64 包在 M1/M2 上会静默失败
装完显示“已启用”，但 defineProps 或 fetch 没补全
这是离线环境最典型的假成功：插件注册了，但 LSP 服务根本没起来。重点检查：
- Volar 类插件：必须手动同步
@vue/language-core到项目node_modules/，且tsconfig.json含"types": ["vue"]和"include": ["src/**/*.vue"] - Python/JS 补全类插件（如
ms-python.python）：首次打开文件时才会拉pyright或prettier，离线需提前在有网机器上完整走一遍流程，再拷整个扩展目录（含server/或out/子目录）到内网~/.vscode/extensions/ - 确保
editor.inlineSuggest.enabled为true（VSCode 1.86+ 默认开），并关掉冲突插件如github.copilot.inlineSuggest.enable
Windsurf 是离线补全最稳的选择
它不依赖网络、不弹窗、不抢焦点，模型直接跑在本地，开箱即用。但要注意：
- 它只走
editor.inlineSuggest通道，不会影响Ctrl+Space的传统补全面板 - 别和 TabNine/Copilot 同时启用，否则会因监听同一事件导致建议框空白或卡顿
- 验证方式很简单：打开一个
.ts文件，敲fetch，看行尾是否立刻浮现带参数签名的建议（非网络请求）
真正难的从来不是“怎么装”，而是确认 @volar/vue-language-server 这类二进制有没有被正确解压进扩展目录、typescript.tsdk 路径有没有指向本地 node_modules/typescript、以及 VSCode 托盘进程是否彻底退出再重开——这些细节漏掉一个，补全就永远卡在“看起来装好了”。
