直接复制.vscode/extensions文件夹不可行，因其含平台相关二进制、node.js绑定代码及vscode缓存，跨版本/架构易致加载失败；须用code --list-extensions --show-versions导出带版本号的插件id列表，并以utf-8编码保存，重装时加--force和timeout避免卡死。
插件更新前不做状态备份，大概率会遇到扩展图标消失、设置页空白、Cannot find module './extension' 报错，甚至语言包失效——这不是个别现象，而是跨版本/跨架构还原的必然结果。
为什么直接复制 .vscode/extensions 文件夹不行
这个文件夹只是插件解压后的运行时产物，不是可移植包。它包含大量平台相关二进制（如 ms-vscode.cpptools 的 native 模块）、Node.js 版本绑定代码和 VSCode 内部缓存结构。一旦目标机的 VSCode 版本、CPU 架构（x64 vs arm64）或 Node.js 运行时不一致，就会触发加载失败。
- Windows 上复制到新设备后，
esbenp.prettier-vscode可能显示“已安装”但右键无格式化菜单 - macOS M1 机器上从 Intel 机器复制来的
ms-python.python扩展，首次激活时卡在“Starting Python Language Server” - Linux 上
rust-lang.rust-analyzer的rust-analyzer二进制文件权限丢失，日志报Permission denied
必须导出带版本号的插件 ID 列表
仅用 code --list-extensions 导出是危险的：它不带版本信息，恢复时会装最新版，而新版可能破坏项目兼容性（例如 ms-python.python@2026.4.1 替换掉项目锁定的 @2025.12.1）。
- 正确命令：
code --list-extensions --show-versions > extensions-with-ver.txt - 输出格式为
publisher.name@x.y.z，这是唯一能跨环境复现的最小单元 - Windows 用户务必用
>而非>>，否则多次导出会混入旧记录 - 文件保存编码必须是 UTF-8，否则含中文 publisher 名（如某些国内定制插件）会乱码
批量重装必须加 --force 并设超时
默认 code --install-extension 行为是同步阻塞，某个插件签名校验失败或网络超时，整个流程就卡死。尤其像 ms-vscode.cpptools 这类插件，即使离线也会尝试连微软服务器验证证书。
- Linux/macOS 推荐脚本：
while read ext; do timeout 120 code --install-extension "$ext" --force || true; done - PowerShell 中：
Get-Content extensions-with-ver.txt | ForEach-Object { code --install-extension $_ --force }，但需提前关闭 VSCode 设置里的Extensions: Auto Update -
--force跳过“已存在”提示，避免单个插件重复安装中断流程 -
|| true或try/catch确保单个失败不影响后续安装
中文界面和 SSH 配置不在备份范围内
Settings Sync 和插件 ID 列表导出都**完全不覆盖**这两类关键状态：
- 中文界面：Sync 会同步
"locale": "zh-cn"字段，但不会同步语言包本身。新设备上必须手动安装Chinese (Simplified) Language Pack for Visual Studio Code插件，并执行Configure Display Language → zh-cn → Reload Window - SSH 配置：
%USERPROFILE%\.ssh\config和known_hosts是 Remote-SSH 连接必需，必须单独备份并覆盖还原 - Prettier/ESLint 等插件的配置文件（如
.prettierrc、.eslintrc.js）存在于项目根目录或全局路径，不在 Sync 范围内，需随项目一起 Git 管理或单独归档
真正可靠的备份，不是拷一个文件夹，而是把插件还原逻辑拆成可验证、可重放、可审计的三步：导出带版本的 ID 列表、手动补全语言包与 SSH、用带超时和容错的脚本重装。最容易被忽略的是——你永远不知道哪个插件会在重启后第一次激活时才暴露兼容性问题，所以备份后务必打开所有常用工作区，手动触发一次扩展激活。
