code --install-extension 是唯一可靠离线安装方式，因其触发校验→解压→注册→激活完整生命周期；路径含空格/特殊字符须加引号；报错“not compatible”主因是vscode版本与插件engines字段不匹配或架构不符；vue等插件需整目录迁移language server；自动更新须分主程序、插件、系统三层关闭。
code --install-extension 是离线安装插件的唯一可靠入口，图形界面拖拽、双击、复制 .vsix 文件到 extensions 目录，全都不算真正安装——VSCode 不会解压、不注册、不校验依赖，插件名可能出现在列表里，但补全/调试/格式化一律失效。
为什么 code --install-extension 必须用，且不能省略路径引号
命令行安装是唯一触发完整生命周期（校验 → 解压 → 注册 → 激活）的方式。常见失败不是因为网络，而是：
• Windows 下路径含空格或中文时，不加双引号会导致截断，例如 code --install-extension C:\my ext\python.vsix 实际只读取了 C:\my；
• macOS/Linux 中路径含特殊字符（如 &、(）同样需包裹单引号或双引号；
• 若提示 command not found: code，说明 CLI 未注入 PATH，必须先在 VSCode 中按 Ctrl+Shift+P 运行 Shell Command: Install 'code' command in PATH。
Extension is not compatible with Code 的真实原因和快速排查法
这个报错 95% 和网络无关，是版本硬性拦截。VSCode 安装时会比对两个关键值：
• 本地版本：运行 code --version，取前两段（如 1.85.2 → 1.85）；
• 插件要求：解压 .vsix（它本质是 zip），打开 extension/package.json，查 "engines": {"vscode": "^1.80.0"} 字段；
• 架构匹配：ARM Mac 装 x64 版本的 ms-python.python 或含 pyright 二进制的插件，必然失败，需找带 darwin-arm64 标识的构建包；
• 别信“最新版就行”——某些插件（如旧版 Vue 工具链）已停止维护，只兼容 ^1.72.0，强行装 1.85 就静默拒绝。
Vue 相关插件离线安装后补全/语法检查不生效？你漏了 language server
像 Vue、JavaScript、TypeScript 类插件，安装 .vsix 只是第一步。首次激活时，它们会自动下载对应 language server（如 volar-server、tsserver），这个过程默认走外网，离线环境会卡在状态栏“Downloading volar…”或输出面板报 Failed to fetch。
解决办法不是重下 .vsix，而是：
• 在有网机器上完整触发一次：打开 .vue 文件 → 等状态栏变绿 → 关闭 VSCode；
• 找到对应扩展目录（如 ~/.vscode/extensions/vue.volar-1.12.0），整个文件夹拷到内网机相同路径；
• 切勿只拷 .vsix，否则 server 子目录、node_modules、预编译二进制全丢失。
自动更新必须分三层关死，否则半夜弹窗或静默拉包
VSCode 的更新机制是解耦的，关掉一个开关毫无意义：
• 主程序层：设 "update.mode": "none"（用户 settings.json） + 修改安装目录下 product.json 中的 updateMode 字段为 "none"；
• 插件层：显式关闭 "extensions.autoUpdate": false 和 "extensions.autoCheckUpdates": false，并检查项目级 .vscode/settings.json 是否覆盖了该设置；
• 系统层：Windows 需禁用后台服务（任务管理器 → 启动项中禁用 Code.exe 相关条目），macOS 运行 defaults write com.microsoft.VSCode AppleAutomaticTermination -boolfalse，Linux snap 用户执行 sudo snap refresh --hold vscode。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
