VSCode插件搜不到或提示不兼容，主因是平台限制未匹配；可下载对应.vsix手动安装，必要时解压修改package.json中的os/arch字段后重打包。
VSCode 插件市场里搜不到某个插件，或者点击安装提示“不兼容”，大概率不是插件下架了，而是它没声明支持你当前的系统平台（比如只标了 win32 或 darwin），或你用的 VSCode 构建版本和插件要求的平台不一致——尤其是 ARM64、Linux ARMv7、Web（vscode.dev）这些非主流目标平台。
插件详情页显示“Not available on your platform”
这是最直白的提示：插件作者在 package.json 的 engines 或 extensionKind 里写了平台限制，VSCode 市场端直接过滤掉了。常见于：
- Remote-SSH、WSL、Dev Containers 类插件，常标注
"extensionKind": ["ui", "workspace"]，但某些旧版只支持ui，在纯 Web 版 vscode.dev 上就不可见 - 含本地二进制依赖的插件（如
ms-vscode.cpptools的 C++ IntelliSense server），package.json里会列出os和arch字段，例如"os": ["win32"]，Linux 用户就搜不到 - 某些插件 GitHub Release 页面只打了
.vsixforx64，但你用的是 M1/M2 Mac（darwin-arm64），Marketplace 就不展示
解决办法不是换源，而是绕过 Marketplace 的平台校验：
- 去插件 GitHub Releases 页面找带
.vsix后缀的资产，下载对应你系统的包（注意看文件名是否含darwin-arm64、linux-x64、win32-arm64等） - 在 VSCode 中执行
Extensions: Install from VSIX，选中该文件 - 如果仍报错
Extension is not compatible with Code，说明.vsix内部extension/package.json的engines.vscode或os/arch字段锁死了平台——需解压修改后重打包（见下一条）
手动安装 .vsix 后提示 “Platform not supported”
VSCode 在安装阶段会读取 .vsix 根目录下的 extension/package.json（不是顶层那个），检查其中的 os、arch 和 extensionKind 字段。哪怕你系统完全匹配，只要字段写死为 ["win32"]，Linux 用户就会被拒。
实操步骤（以 Linux ARM64 为例）：
- 用
unzip（Linux/macOS）或 7-Zip（Windows）打开.vsix文件 - 进入
extension/子目录，编辑package.json - 删掉或放宽
"os"和"arch"字段，例如把"os": ["win32"]改成"os": ["win32", "linux", "darwin"]；把"arch": ["x64"]改成"arch": ["x64", "arm64"] - 保存后，用同一工具重新打包为 zip，再把后缀改回
.vsix - 执行
Extensions: Install from VSIX安装
⚠️ 注意：extensionKind 字段不能乱改。若原值是 ["workspace"]，改成 ["ui"] 可能导致插件无法访问工作区 API；反之亦然。
Web 版 vscode.dev 装不了某些插件
vscode.dev 是纯浏览器环境，不支持任何需要本地进程、Node.js 或文件系统权限的插件。市场页上能看到但点安装失败，错误常是 Extension not supported in this environment 或控制台报 Cannot load extension 'xxx': workspace.fs is not available。
这类插件通常有以下特征：
- 依赖
vscode.workspace.fs（如文件搜索、自动保存类插件） - 调用
vscode.env.openExternal或vscode.window.showOpenDialog - 声明
"extensionKind": ["workspace"]且未提供web兼容入口
目前无通用绕过方案。唯一可行路径是：
- 确认插件是否发布过 Web 版本：查看其 GitHub README 或
package.json是否含"browser": "./dist/web-extension.js"字段 - 若无，只能放弃，或改用本地 VSCode + GitHub Codespaces / Gitpod 等托管开发环境
- 别尝试修改
extensionKind强行安装——VSCode Web Host 会在加载时直接抛出TypeError: fs.readDirectory is not a function并静默禁用
真正容易被忽略的点是：平台兼容性检查发生在三个不同环节——Marketplace 展示时、code --install-extension 下载时、以及 VSCode 加载插件代码时。每个环节的校验粒度不同，所以有时“能搜到却装不上”，有时“能装上却启动失败”。遇到问题先看错误出现在哪一步，再决定该改 URL 参数、换 .vsix、还是动 package.json。
