离线安装vscode扩展成功不等于可用，主因是语言服务器等依赖未下载；需在有网机完整启用插件后复制整个扩展目录至内网机对应extensions路径，并彻底重启vscode。
离线安装 VSCode 扩展本身不难，但“装上就用”是假象；真正卡住的，是插件依赖的语言服务器、CLI 工具或 native 二进制没下载——这些默认走外网，离线时静默失败，补全/格式化/调试全失效。
拖.vsix进VSCode主界面没反应？先看这三件事
这是最常用也最容易翻车的操作。不是.vsix有问题，而是环境没准备好：
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），不能停在「欢迎页」或「远程连接中」状态
- 窗口必须有焦点，且未被全屏应用（如远程桌面、KVM）遮挡或坐标偏移；拖拽时松手位置得落在编辑器白底区域，不是侧边栏或设置页
- 右下角状态栏若显示
Extensions disabled by policy，说明组策略锁死了扩展机制，GUI 和code --install-extension都会无效，需联系管理员
code --install-extension 报 Extension is not compatible
这不是网络错误，是硬性版本拦截。VSCode 启动时会严格比对 package.json 里的 "engines": {"vscode": "^1.75.0"} 和你本地 code --version 输出的第一段（如 1.85.2 → 取 1.85）。
- 解压 .vsix（它本质是 zip），打开根目录下的
package.json，直接查engines.vscode字段 - Windows 下路径含空格或中文时，命令行必须用双引号包裹路径：
code --install-extension "C:/ext/ms-python.python-2023.8.0.vsix" - ARM Mac 装了 x64 构建的插件（尤其含
pyright、esbuild这类 native 二进制的），也会触发此报错；得找带darwin-arm64标识的版本
插件列表显示“已安装”，但 Python 补全不生效
这是离线环境最典型的「假成功」：VSIX 安装通过了，但插件首次启用时要自动下载 language server（如 pyright）或 CLI（如 prettier），这些行为默认走外网，离线会卡在状态栏 Downloading… 或输出面板报 Failed to fetch。
- 别重装 .vsix —— 要在有网机器上完整跑一遍：打开一个
.py文件 → 等状态栏变绿 → 再把整个扩展目录（如~/.vscode/extensions/ms-python.python-2023.8.0）拷到内网机对应路径 - 必须拷完整文件夹，不是只拷 .vsix；否则 native 二进制缺失，
pyright直接无法启动 - 拷完需彻底退出 VSCode（包括右下角托盘进程），再重新打开，否则缓存可能跳过加载
自动保存 ≠ 自动备份，files.autoSave 配错反而更危险
VSCode 没有内置备份功能。files.autoSave 只控制「何时把当前编辑器内容写入原文件」，不生成副本、不记录历史、不防误覆盖。
- 设为
"onFocusChange"看似省心，但在多标签频繁切换时容易漏存（比如切到终端又秒切回，中间修改没触发） - 推荐用
"afterDelay"+"files.autoSaveDelay": 500，延迟够短，又避免光标悬停狂写盘 - 真正防丢靠组合：开
files.hotExit（值必须是"onExitAndWindowClose"）、配 Git 临时提交、再装Local History插件——它会在项目根下建.history/，每次保存前存时间戳快照，右键文件就能回溯
离线环境下，版本兼容性、依赖完整性、配置同步这三点，比安装动作本身重要得多；很多人反复重装 .vsix，却从没打开过 package.json 看一眼 engines 字段。
