code --install-extension 能装上但补全不生效，根本原因是离线环境下插件前端安装成功，而语言服务器、类型包（如@vue/language-core）、CLI工具（如pyright、prettier）等关键依赖未就位；需严格匹配VSCode主版本号、确保ARM/x64架构一致，并完整拷贝扩展目录及底层依赖。
code --install-extension 能装上，但补全不生效——离线环境里，代码补全插件（如 ms-python.python、volarjs.volar、esbenp.prettier-vscode）的“安装成功”和“真能用”之间，隔着版本兼容、依赖完整、语言服务器落地三道硬坎。
拖拽 .vsix 进主窗口没反应？先看这三点
VSCode 只在编辑器主区域（即你写代码的白底窗口）响应未解压的 .vsix 文件拖放，且必须满足三个前提：
- VSCode 正在运行，且窗口已获得系统焦点（任务栏图标高亮）
- 当前不是全屏状态，也未通过 RDP/TeamViewer 这类远程桌面连接（它们会拦截拖放事件）
- 拖的是原始
.vsix文件，不是解压后的文件夹或重命名过的.zip；可用unzip -l xxx.vsix检查顶层是否为extension/目录
code --install-extension 报错 “not compatible with Code” 怎么快速定位
这不是网络问题，是 VSCode 主版本号与插件 package.json 中 "engines": {"vscode": "^1.85.0"} 字段不匹配。实操步骤如下：
- 运行
code --version，取输出第一段（如1.90.2→ 主版本是1.90） - 用
unzip -p xxx.vsix extension/package.json | grep engines（Linux/macOS）或 7-Zip 打开查看该字段 - 确保本地主版本 ≥ 插件要求的最低版本（
^1.85.0表示 ≥1.85.0） - ARM Mac 上装 x64 构建的插件（尤其含 native binary 的，如
pyright或volar-server）也会触发同类报错，必须下载带darwin-arm64标识的版本
插件列表显示“已安装”，但 defineProps 不补全、fetch 不提示参数？
这是离线环境下最典型的“假成功”——插件前端装上了，但语言服务器、类型包、CLI 工具这些关键依赖根本没拉下来。比如：
-
ms-python.python首次打开.py文件时才会自动下载pyright，离线卡在 “Downloading…” -
volarjs.volar的@vue/language-core和@volar/vue-language-server必须手动同步进项目node_modules -
esbenp.prettier-vscode依赖prettierCLI，离线时需提前npm install prettier并确认路径可被插件识别
解决办法不是重装 .vsix，而是：在有网机器上打开对应文件类型 → 等状态栏变绿（如显示 Volar: Ready 或 Python: Ready）→ 把整个扩展目录（如 ~/.vscode/extensions/ms-python.python-2024.6.0）完整拷到内网机对应 extensions/ 路径下。
为什么 Windsurf 是离线补全更稳的选择
它不依赖外部 API，模型轻量、原生走 editor.inlineSuggest 通道，且不抢焦点、不弹窗。但要注意：
- 安装后必须确认
editor.inlineSuggest.enabled为true（VSCode 1.86+ 默认开启） - 关掉其他插件的 inline 模式，比如设
github.copilot.inlineSuggest.enable为false，否则建议打架、输入卡顿 - 别同时启用 TabNine 和 Copilot：两者都劫持
onType事件，冲突后典型表现是输入use弹出空白建议框，或按Ctrl+Space卡死 2 秒
离线补全真正难的不是装插件，而是让所有依赖（TS 语言服务、LSP server、类型包、CLI 工具）全部就位且路径正确——少一个，补全链就断在中间，而 VSCode 很少明确告诉你缺了谁。
