VSCode 1.85+ 因强制校验 engines.vscode 字段静默禁用不兼容插件；Windows 用户优先选 User Installer；macOS/Linux 需匹配芯片与系统版本；VSCodium 不支持微软市场核心扩展，官方版才是微软生态唯一稳妥选择。
VSCode 1.85+ 版本导致插件被静默禁用
如果你的 VSCode 升级到 1.85.0 或更高（比如当前最新稳定版 1.127.0），而某些插件（如 fitten.fitten-code）突然消失、右键无响应、命令面板搜不到，大概率不是插件损坏，而是 VSCode 强制校验 engines.vscode 字段后自动禁用——它只认 package.json 里声明的兼容版本范围，UI 上点“启用”会立刻再次禁用。
验证方法：按 Ctrl+Shift+P → 输入并执行 Extensions: Show Installed Extensions → 点右上角筛选器选 Disabled。若插件出现在该列表且顶部标有 Disabled，就确认是这个原因。
- 不要手动改已安装插件目录下的
package.json：VSCode 启动时会重新校验并可能重置 - Marketplace 页面 URL 后追加
?vscodeVersion=1.127.0（用你本地code --version输出的实际版本替换），刷新后看是否出现Install Another Version…下拉菜单 - 只安装带绿色勾号 ✅ 的历史版本——那是 Marketplace 显式验证过的兼容 release
Windows 用户该选 User Installer 还是 System Installer
绝大多数 Windows 用户应该选 VSCodeUserSetup-x64-*.exe（User Installer），而不是 System Installer。前者装在当前用户目录下，不依赖管理员权限，插件安装、更新、调试器注册更稳定；后者需要 UAC 提权，容易在公司电脑或受限环境中失败，且卸载残留多。
典型反例：code --version 报错、Remote - SSH 扩展无法加载 WebView、GPU 加速失效——这些常源于 installer 权限模型与 Electron 原生模块 ABI 不匹配。
- User Installer 支持“添加到 PATH”，务必勾选，否则终端敲
code .会提示 command not found - System Installer 适合多用户共享的办公电脑，但需确保所有用户账户都有对应权限配置
- 如果已在用 System Installer 且频繁出问题，直接卸载 + 改用 User Installer 是最干净的解法
macOS 和 Linux 用户注意芯片与发行版对齐
macOS 用户别只看系统版本，必须核对芯片类型：uname -m 返回 aarch64 就是 Apple Silicon（M 系列），返回 x86_64 是 Intel。官网下载页的 Universal 版本虽宣称兼容两者，但实测中部分扩展（如含原生 node-pty 的终端插件）在 M3 Mac 上仍会因 libffmpeg.so 加载失败而黑屏。
Linux 用户重点看包格式和 glibc 版本：.deb 对应 Debian/Ubuntu，.rpm 对应 Fedora/RHEL/CentOS，.tar.gz 是通用版但需手动处理依赖。内核低于 3.10 或 glibc 低于 2.17 会导致启动失败或调试协议异常。
- Arch Linux 用户慎用 AUR 的
vscodium-bin-marketplace：它预设微软 market 地址，但每次升级可能被覆盖回 Open VSX - WSL2 环境推荐用官方
.deb包而非 Windows 版本的 Remote - WSL 扩展直连，避免跨子系统图形栈冲突 - Linux 服务器无 GUI 场景，优先考虑
code-server而非桌面版 VSCode
别把 VSCodium 当成“去微软版 VSCode”来用
VSCodium 默认连接的是 https://open-vsx.org/vscode/gallery，不是微软市场。这意味着 ms-python.python、ms-vscode.powershell、GitHub.copilot 这类核心扩展要么没有，要么滞后数周甚至完全不可用。
有人试图通过修改 resources/app/product.json 中的 extensionsGallery.serviceUrl 强行切到微软市场，但微软明确不支持该配置，且部分扩展（如 Remote - SSH）会在运行时检测环境并拒绝加载。
- 如果你重度依赖微软生态插件，官方版是唯一稳妥选择
- VSCodium 用户想临时用某个微软扩展，只能找社区打包的离线
.vsix并手动安装，但后续更新需重复操作 - Code-OSS 更不可取：它只是源码树，没预编译二进制，所谓“自己编译”实际产出的是阉割版，缺调试协议适配层，
debugger-for-chrome类扩展根本注册不了
真正卡住人的从来不是“哪个版本能装上”，而是“装上之后哪些扩展能活下来、哪些功能能跑通”。版本选择本质是信任链选择：你信微软的构建、遥测和市场闭环，还是信开源社区的透明和去中心化——但别指望二者能无缝互换。
