VSCode离线迁移需分三步：插件用code --list-extensions导出ID列表并--install-extension --force批量安装；快捷键配置靠复制keybindings.json文件；代码片段须手动复制.snippets目录下JSON文件至目标机对应路径并重载窗口。
离线环境下，.vsix 插件包能直接导入，但代码片段（.code-snippets）不能靠拖拽或命令行安装——它们是纯配置文件，必须手动放对位置、命名规范、并触发重载。
拖 .vsix 文件进 VSCode 主窗口为什么有时没反应
这不是 bug，是焦点和上下文没满足。VSCode 只在「已加载工作区 + 有系统焦点 + 非全屏/远程状态」下响应拖放。常见卡点：
- VSCode 启动后停留在空白页（没打开文件夹或文件），此时拖入无效
- 窗口被远程桌面（如 RDP）、全屏应用或 macOS 的 Mission Control 遮挡，拖放事件被拦截
- 右下角状态栏显示
Extensions disabled by policy，说明组策略禁用了扩展，GUI 和 CLI 均失效 - 误拖了已解压的文件夹或
.zip，VSCode 只认原始未解压的.vsix（本质是 zip，但顶层必须含extension/目录）
code --install-extension 命令失败的三个硬性条件
该命令不联网，但校验极严。失败几乎都源于路径、版本或架构不匹配：
- 路径必须是绝对路径：Linux/macOS 用
/home/user/ext/python-2024.6.0.vsix，Windows 推荐正斜杠C:/ext/python.vsix；含空格需加英文双引号"C:/my ext/python.vsix" - 版本必须 ≥
package.json中"engines": {"vscode": "^1.80.0"}声明的最低版：运行code --version得到1.85.2→ 取前两位1.85，需 ≥1.80 - 架构要一致：ARM Mac 上装 x64 构建的插件（尤其含 native 二进制的，如
ms-vscode.cpptools）会静默失败，得找带darwin-arm64标识的版本
代码片段（.code-snippets）不是插件，不能“安装”
它没有 .vsix 包，也不走扩展机制，而是纯 JSON 配置文件。离线迁移只需两步：
- 全局片段：复制
~/.vscode/snippets/*.code-snippets（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\User\snippets\（Windows）下的文件到目标机同路径 - 语言专属片段：按语言 ID 命名，如
javascript.code-snippets，放同一目录即可生效；若想只作用于当前项目，放.vscode/snippets/子目录下（需手动创建） - 改完后无需重启 VSCode，但需确保文件编码为 UTF-8，且 JSON 格式合法（VSCode 会在设置页报错提示语法问题）
语言类插件“已安装却没效果”的真实原因
显示“已安装”只是把 .vsix 解压进了 extensions/ 目录，不代表功能就绪。Python、Prettier、Rust 等插件首次激活时会自动下载 language server 或 CLI 工具（如 pyright、prettier、rust-analyzer），这些行为默认走外网。
- 离线机器上打开
.py文件，状态栏卡在Downloading...，输出面板（View → Output→ 切换到Python通道）会显示Failed to fetch - 解决办法不是重装
.vsix，而是在有网机器上完整走一遍流程：打开对应文件类型 → 等下载完成 → 状态栏变绿 → 再把整个扩展目录（如~/.vscode/extensions/ms-python.python-2024.6.0/）拷到内网机同路径 - 注意：必须拷整个目录，不能只拷
.vsix；也不能只拷目录里的内容，否则 native 二进制缺失，spawn ENOENT错误必然出现
