复制VSCode插件前必须确认其已完整初始化：在联网机打开对应类型文件、等状态栏显示“Ready”、彻底退出VSCode（含托盘进程）后再复制；目录名须与vsix解压顶层名一致，且VSCode主版本号须严格匹配插件engines.vscode字段。
复制扩展目录前必须确认插件是否已完整初始化
直接复制 extensions 目录下某个插件文件夹到离线机，看似最省事，但 80% 的失败都卡在这一步：插件没真正“活”过。比如 ms-python.python 安装后首次打开 .py 文件才会触发 pyright-server 下载；volarjs.volar 同样要加载 .vue 文件才拉取 LSP 二进制。离线机上只复制空壳目录，状态栏永远显示 “Downloading…”。
正确做法是：在联网机器上完成一次「真实启用」——打开对应类型文件、等右下角状态栏出现 “Ready” 或语言服务图标稳定显示、再关掉 VSCode（包括托盘进程），最后拷贝整个插件目录。
- 检查是否初始化成功：进入
~/.vscode/extensions/ms-python.python-2026.6.123456/，看是否存在out/server/或dist/pyright.bundle.js类路径 - 若只有
package.json、README.md、node_modules（但无bin或server子目录），说明 LSP 未下载，不能直接迁移 - 某些插件（如
esbenp.prettier-vscode）不依赖外部服务，可跳过此步；但语言类、调试类、格式化类插件几乎全部需要
解压 vsix 后的目录名必须原样复用，不能重命名
.vsix 不是普通 zip，它内部顶层目录名就是插件 ID + 版本号，VSCode 启动时靠这个路径识别插件身份。手动解压后若把 ms-python.python-2026.6.123456/ 改成 python/ 或删掉版本号，VSCode 会直接忽略该目录。
验证方法：用 unzip -l your-extension.vsix | head -n 5 查看第一行输出，例如：
Archive: python.vsix
Length Date Time Name
--------- ---- ---- ----
0 09-15-2026 14:22 ms-python.python-2026.6.123456/这个 ms-python.python-2026.6.123456/ 就是你要完整保留的目录名。
- Windows 路径：复制到
%USERPROFILE%\.vscode\extensions\下，保持子目录名不变 - macOS/Linux 路径：复制到
$HOME/.vscode/extensions/下，同样不能改名 - 切勿把子目录里的内容（
package.json、out/等）单独拖出来放到extensions/根目录——VSCode 不认
复制完必须彻底退出 VSCode，包括托盘残留进程
VSCode 的插件缓存机制很顽固。即使你关掉了所有窗口，右下角托盘里还挂着一个 Code Helper (Renderer) 进程，它就会继续读旧缓存，导致新复制的插件不显示、不激活、甚至报 Extension 'xxx' is not found。
强制清理方式：
- Windows：任务管理器 → 结束所有名为
Code.exe和Code Helper*的进程 - macOS：活动监视器 → 搜索
Code→ 全部退出；或终端执行pkill -f "Code\ Helper" - Linux：终端运行
pkill -f "code"或killall code - 重启后，在命令面板输入
Developer: Toggle Developer Tools，Console 里不报插件路径错误，才算真正加载成功
VSCode 主版本与插件 engines.vscode 必须严格匹配
这不是兼容性建议，而是硬性校验：VSCode 启动时会读取插件 package.json 中的 engines.vscode 字段（如 "^1.90.0"），若当前 VSCode 是 1.89.2 或 1.91.0，插件会被静默禁用，扩展面板里显示灰色“Disabled”且无法启用。
查版本的方法：
- VSCode 左下角 → 点击版本号 → 弹出窗口显示完整版本（如
1.90.2） - 插件目录中打开
package.json→ 找"engines": {"vscode": "^1.90.0"}字段 - 两者主版本号（
1.90.x中的1.90）必须完全一致；^1.90.0不接受1.89.9，也不接受1.91.0 - 常见坑：公司统一推送的 VSCode 是 LTS 版（如
1.85.0），但你下载的插件要求^1.90.0，此时只能降级插件版本，去 Marketplace 的 Version History 找匹配项
真正卡住人的，从来不是“怎么复制”，而是复制前没确认 LSP 是否就绪、复制后没杀干净进程、或者根本没核对 engines.vscode 和本地 VSCode 主版本号是否咬合。这三个点漏掉任意一个，插件就只是躺在磁盘上的文件夹。
