插件配置备份必须导出带版本号的id列表，直接复制.vscode/extensions文件夹无效；正确做法是用code --list-extensions --show-versions > extensions.txt命令导出，windows注意用>而非>>，文件编码须为utf-8；中文界面同步失败需手动安装语言包并配置locale.json路径；ssh、pretterrc等配置及ui状态不在settings sync范围内；批量安装插件需加--force并设超时。
插件配置备份必须导出带版本号的 ID 列表
直接复制 .vscode/extensions 文件夹是无效的——它只是解压后的运行时产物，跨系统、跨 VSCode 版本、跨 CPU 架构时二进制不兼容，常见现象是插件图标消失、设置页空白、报错 Cannot find module './extension'。
正确做法是用命令导出可复现的插件清单：
-
code --list-extensions --show-versions > extensions.txt：必须加--show-versions，输出格式为publisher.name@x.y.z，否则恢复时可能装上破坏性更新版本（如ms-python.python@2026.4.1替代项目依赖的@2025.12.1） - Windows 用户注意重定向符号用
>，别写成>>，否则多次导出会混入旧记录 - 文件保存编码必须为 UTF-8，否则含中文 publisher 名（如国内定制插件）会乱码
中文界面同步失败，90% 是因为缺语言包或 locale.json 位置错
Settings Sync 会同步 "locale": "zh-cn" 这个字段，但不会同步语言包本身。新设备上即使 settings.json 里有该配置，界面仍显示英文——VSCode 启动时发现无对应资源，自动 fallback 到 en。
必须分两步手动操作：
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 在每台设备上单独安装官方语言包：
Ctrl+Shift+X→ 搜索Chinese (Simplified) Language Pack for Visual Studio Code→ 点击安装 → 重启 VSCode - 再执行
Ctrl+Shift+P→Configure Display Language→ 选zh-cn→ 点Reload Window（不是关掉重开，也不是Ctrl+R） - 验证路径：
locale.json必须落在用户级目录下（如%APPDATA%\Code\User\locale.json或~/.config/Code/User/locale.json），写到工作区.vscode/locale.json无效
SSH 配置和插件自身配置不在 Settings Sync 范围内
Settings Sync 只管 settings.json、快捷键、代码片段、插件 ID 列表，它不管：
-
%USERPROFILE%\.ssh\config和known_hosts：Remote-SSH 连接必需，必须单独备份并覆盖还原 - Prettier 的
.prettierrc、ESLint 的.eslintrc.js等插件级配置文件：它们存在项目根目录或全局配置路径，Sync 不触碰 - 某些插件的 UI 状态（如 GitLens 的分支视图展开状态）、调试器断点持久化数据：这些属于工作区缓存，存在
%APPDATA%\Code\User\workspaceStorage，需一并备份
批量安装插件时容易卡死，必须加 --force 并设超时
code --install-extension 默认行为是逐个同步等待，遇到网络抖动、签名校验失败或插件后台连更新服务器（如 ms-vscode.cpptools），就会无限挂起。
安全执行方式：
- Linux/macOS：
while IFS= read -r ext; do timeout 120 code --install-extension "$ext" --force || true; done - PowerShell（Windows）：
Get-Content extensions.txt | ForEach-Object { code --install-extension $_ --force } - 务必提前关闭 VSCode 设置里的
Extensions: Auto Update，避免安装中途被后台更新打断 -
--force跳过“已存在”提示，防止流程中断；|| true或try/catch保证单个失败不影响后续
真正麻烦的不是步骤多，而是每个环节都有隐性依赖：语言包没装好，locale 就是摆设；SSH 配置漏了，远程开发直接瘫痪；插件装了但没配好 Python 解释器路径，编辑器就静默拒绝工作——这些都得人眼核对，没法一键全包。
