VS Code安装提示“系统不兼容”本质是环境版本不足，CentOS 7/Ubuntu 18.04常见报错为FATAL: kernel too old或glibc/libstdc++版本不满足，需降级至兼容版本（如code-server v4.16.1或VS Code 1.74.3）而非升级系统。
VS Code 安装提示“系统不兼容”，基本不是安装包坏了，而是你当前系统环境（内核、glibc、libsecret 或桌面库）达不到所选 VS Code 版本的最低要求——它拒绝启动，不是卡住，是直接报错退出。
CentOS 7 / Ubuntu 18.04 等旧系统启动失败
这类系统常见报错包括：FATAL: kernel too old（内核 libstdc++.so.6: version `GLIBCXX_3.4.25' not found（glibc 太旧）、或安装 rpm/deb 包时提示 failed dependencies。
- CentOS 7 默认内核是
3.10.0，VS Code Desktop ≥1.85 和 code-server ≥1.99 都不再支持；实测稳定可用的是code-1.74.3（rpm）或code-server v4.16.1（tar.gz） - Ubuntu 18.04 自带
glibc 2.27，而 VS Code ≥1.86 编译依赖glibc 2.28+；强行安装会失败，且apt --fix-broken install无效——系统仓库不提供更高版本 - 别碰
yum localinstall或dpkg -i后加--force：可能装上但运行崩溃，GUI 输入/渲染异常概率极高
安装后黑屏、无响应或无法打开 GUI
不是程序没启动，而是图形依赖缺失。VS Code Desktop 是 Electron 应用，依赖系统级 GUI 库（如 libxkbfile1、libsecret-1.so.0、libgtk-3.so.0），旧系统常缺其中一两个。
- CentOS 7：必须提前装
sudo yum install -y libsecret-1.so.0 gtk3 atk atk-devel，否则即使 rpm 装成功，首次启动也黑屏 - Ubuntu 18.04：补装
sudo apt install -y libxkbfile1 libsecret-1-0 libgtk-3-0，注意libxkbfile1要 ≥1:1.1.0，官方源没有，得手动编译或换镜像源 - 银河麒麟等国产系统：若桌面图标不可见，需手动生成
.desktop文件并chmod +x，否则只能命令行code --no-sandbox启动
离线安装 .vsix 插件报 “not compatible with Code 'X.Y.Z'”
错误本质是插件包里 package.json 的 "engines": {"vscode": "^A.B.C"} 字段和你本地 code --version 输出的主版本不匹配——VS Code 根本不加载该插件，更不会报运行时错。
- 不要双击 .vsix 解压（Windows 资源管理器会破坏 ZIP 结构），用
unzip（Linux/macOS）或 7-Zip（Windows）打开 - 改的是
extension/package.json（不是外层那个），把"vscode": "^1.85.0"改成"vscode": ">=1.85.0 ，避免写死 <code>=1.90.2（小版本更新后又失效） - 改完保存，用
zip -r xxx.vsix *重新打包，再通过命令面板Extensions: Install from VSIX安装
真正麻烦的不是版本号本身，而是底层依赖链断裂——比如你改了插件的 engines 字段，但 VS Code 进程根本没加载 vs/nls.js（≤1.75 版本默认禁用），那中文包照样不生效。这种问题得一层层查，不能只盯着报错文字。
