vscode主程序与插件engines版本必须对齐，否则插件禁用、右键菜单消失、语言服务不响应；需确保package.json中"engines":{"vscode":"^1.85.0"}与code --version匹配，不匹配则vscode启动时硬校验失败。
VSCode主程序与插件的engines版本必须对齐
插件禁用、右键菜单消失、语言服务不响应——这些不是随机故障，而是package.json里"engines": {"vscode": "^1.85.0"}和你本地code --version不匹配的直接结果。VSCode启动时会硬校验这个字段，不满足就拒绝加载。
- 打开扩展面板，点插件右下角⋯ → Install Another Version…，选一个明确标注支持你当前版本的旧版（如你用1.84.2，就别选标“>=1.85.0”的）
- 如果该选项灰显，说明插件作者没发布历史版本；此时需手动解压
.vsix，修改根目录package.json中的vscode字段，例如从">=1.103.0"改为">=1.84.0 - 改完保存，用7-Zip重打包为zip，再把后缀名改回
.vsix，最后通过扩展面板的“从VSIX安装”导入
Remote-SSH连不上？先查commit ID，不是看版本号
报错Failed to fetch commit hash或卡在Setting up SSH Host，90%是因为你手动放的vscode-server包和本地VSCode的Git commit ID对不上。版本号1.91.0没用，真正起作用的是那个40位的哈希值，比如6f12b6e0c9a5e7d8f0b1c2d3e4f5a6b7c8d9e0f1。
- 在本地终端运行
code --version，第二行就是commit ID - 登录远程服务器，检查
~/.vscode-server/bin/下是否存在对应ID的子目录；没有就别指望它能启动 - 离线部署时，必须去
https://update.code.visualstudio.com/commit:<commit_id>/server-linux-x64/stable</commit_id>下载精确匹配的tar包（注意替换URL里的<commit_id></commit_id>） - 解压后路径必须是
~/.vscode-server/bin/<commit_id>/</commit_id>，多一级或少一级都会失败
Windows 7或CentOS 7这类老系统，必须锁死旧版本组合
Chromium 104之后不再支持Windows 7，glibc 2.28之后才支持新版code-server——这意味着你不能只换VSCode或只换单独组件，必须整套降级。
- Win7用户唯一可行版本是
1.70.3（官方最后支持版），必须用zip免安装包，不能装msi/rpm - CentOS 7上不要碰
code-server v5.x，改用v4.16.1，它兼容kernel 3.10和glibc 2.17 - VSCode Desktop rpm在CentOS 7上会因
libsecret版本低而失败，实测可用的是code-1.74.3-1673284922.el7.x86_64.rpm，安装前先yum install libsecret-1.so.0 - 所有旧版本都绕不开一个事实：它们不会收到新安全补丁，生产环境务必隔离使用
Python解释器、pip、Pylance三者路径必须完全一致
import失败、类型提示乱码、调试器断点不触发——这些问题背后往往只是python命令指向A路径，而pip装在B路径，Pylance又在C路径读取缓存。VSCode不会自动帮你对齐这三者。
- 在集成终端运行
which python（macOS/Linux）或where python（Windows），记下输出 - 在Python文件中写
import sys; print(sys.executable)并运行，对比输出是否和上面完全一致 - 不一致就立刻按
Ctrl+Shift+P→Python: Select Interpreter，选带完整路径的条目（例如Python 3.11.5 ('venv': venv)） - 装库必须用
python -m pip install xxx，避免sudo pip install污染系统环境
、glibc小版本差0.1，都足以让整个链路中断。最省事的做法，永远是先确认本地<code>code --version输出的完整字符串，再按这个字符串去找所有配套组件——而不是反过来。
