最常导致语言服务器崩溃、调试器失联或格式化失效的是插件版本不一致；需禁用自动更新（extensions.autoUpdate: false）、启用自动下载（sync.autoDownload: true），并通过sync.ignoredExtensions排除不兼容插件并手动锁定版本。
同步插件列表但禁用自动更新
多台设备上插件版本不一致，最常导致语言服务器崩溃、调试器失联或格式化失效——这不是配置问题，而是版本跳变引发的兼容断裂。直接后果是：你在办公室写的 Python 代码，回家打开就报 ModuleNotFoundError: No module named 'pylsp'。
必须把“装哪些插件”和“装哪个版本”拆开管：
-
sync.autoDownload设为true（默认），确保新设备首次同步时自动安装插件 ID 对应的当前最新版 -
extensions.autoUpdate设为false，彻底关闭后台静默升级，避免写到一半突然弹出“Python extension updated”并重载语言服务 - 修改后无需重启，VSCode 立即生效；但已触发的升级进程可能还在跑，可打开
Developer: Toggle Developer Tools→Network标签页，过滤marketplace.visualstudio.com确认无活跃请求
为特定插件锁定版本（如 ms-python.python）
VSCode 原生不支持在 settings.json 里指定扩展版本号，所谓“锁定”本质是「禁用自动更新 + 手动降级 + 防止同步覆盖」三步操作。
以 ms-python.python 为例，常见踩坑点：
- 右键扩展 →
Install Another Version…选旧版（如2024.8.1）后，仅当前设备生效；其他同步设备不会继承该版本，除非你额外处理 - 若启用了 Settings Sync，需在
settings.json中加入"sync.ignoredExtensions": ["ms-python.python"]，否则下次同步会把新设备拉回最新版 - 降级后检查
Developer Tools → Console是否有Failed to activate extension ms-python.python报错——这说明旧版与当前 VSCode 内核（如 1.92.x）存在 API 不兼容，得换更匹配的版本
跨平台同步时跳过不兼容插件
macOS 和 Windows 共用同一套同步配置，但 ms-vscode.cpptools 在 macOS 上只提供 ARM64 版本，而你的 Windows 笔记本是 x64，结果就是新设备反复尝试安装失败，状态栏一直显示 Unsupported。
正确做法不是等它重试，而是主动排除：
- 在
settings.json中添加sync.ignoredExtensions数组，填入插件 ID（如"ms-vscode.cpptools"） - ID 必须准确，可从扩展详情页 URL 提取：
https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools→ms-vscode.cpptools - 别误加主题类插件（如
dracula-theme.theme-dracula），它们跨平台兼容，忽略反而导致界面风格不一致
用命令行批量管理插件（适合团队初始化）
新同事入职或 CI 环境部署时，靠 Settings Sync 同步太慢，且无法控制版本。此时应绕过 UI，用 VSCode CLI 直接操作。
关键命令和限制：
- 导出当前插件列表：
code --list-extensions > extensions.txt，生成纯文本 ID 列表 - 批量安装（支持指定版本）：
code --install-extension ms-python.python@2024.8.1，注意 @ 符号不可省略 - 国内用户务必配镜像源，否则
code --install-extension会卡在Downloading...：在settings.json加"extensions.gallery.serviceUrl": "https://vscode.bing.com/api/gallery"（微软官方国内镜像） - 该方式不走 Settings Sync，也不受
extensions.autoUpdate影响，适合固化环境
