必须手动安装指定旧版vscode，因官方不支持降级；需从官网归档页下载匹配版本安装包，装前禁用自动更新、备份设置并清理插件目录，装后重命名extensions文件夹以重建兼容环境。
必须换版本，不是调设置能解决的——VSCode 本身不支持“降级”，所谓“版本过低”实际是插件或工具链在运行时检测到 vscode.version 不满足 engines.vscode 要求，或调用的底层 API 已被移除。硬改配置、清缓存、重装插件都绕不开这个校验点。
确认当前 VSCode 版本和插件要求的最低版本
别凭印象判断，先看真实数字：
- 终端执行
code --version，记下第一行（如1.79.2） - 下载的
.vsix文件改后缀为.zip，解压后打开extension/package.json - 找
"engines": { "vscode": "^1.85.0" }这一行——这就是插件声明的最低兼容门槛 - 如果
1.79.2 ，安装必然失败；即使装上，启动时也会被自动禁用
手动安装指定旧版 VSCode（唯一可靠路径）
官网提供全部历史版本，但入口隐蔽，且 Windows/macOS/Linux 安装逻辑不同：
- 直连归档页：https://www.php.cn/link/87adca4eecbfdc6eda81cde400ec4fbd（把
v1_79换成你要的版本，如v1_80） - Windows：下载
VSCodeSetup-x64-*.exe，**不要选 User Installer**（它会受系统策略干扰） - macOS：下载
.zip解压后拖入Applications，首次启动前右键「显示简介」→ 勾选「仍要打开」 - Linux：下载
.tar.gz，解压后直接运行./Code；若用apt安装过，先sudo apt remove code再解压，避免/usr/bin/code软链接残留
装完立刻禁用自动更新并清理插件缓存
否则几小时后就被推成新版，前功尽弃：
- 启动新装的旧版 VSCode，按
Ctrl+,打开设置，搜update.mode，设为none - 检查
settings.json中是否已写入"update.mode": "none"，没有就手动加 - 重命名插件目录：
~/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\.vscode\extensions\（Windows）→ 改成extensions-backup - 重启 VSCode，让它重建空的
extensions目录，再逐个安装匹配该版本的插件
远程开发（Remote-SSH）必须同步远端 vscode-server 版本
本地装对了没用，远端 ~/.vscode-server 二进制不匹配照样卡在 Starting VS Code Server：
- 连接前先在远端服务器执行：
rm -rf ~/.vscode-server - 再触发 VSCode 连接，它会自动下载与本地主程序完全一致的 server 包（比如本地是
1.80.2，远端就下1.80.2的 server） - 如果远端是 CentOS7，glibc 2.17 不支持新版 server，就得连带降级本地 VSCode 到
1.76.x或更早（查 官方兼容表）
最易忽略的一点：改完 update.mode 后，务必检查任务管理器（Windows）或活动监视器（macOS）里有没有残留的 Code Helper (Renderer) 进程——它们可能还在跑旧版逻辑，导致新设置不生效。
