私有云中VSCode插件更新必须用code --install-extension配合绝对路径、--force参数及手动重载，且需严格匹配VSCode主版本、预置LSP二进制、关闭自动检查与同步。
私有云环境无法直连 marketplace.visualstudio.com，必须绕过在线检查、手动控制安装路径与版本兼容性，否则 Extensions: Update All Extensions 会卡住或静默失败。
用 code --install-extension 替代图形界面更新
私有云机器通常禁用外网访问，图形界面点击“Update”会无限等待 marketplace 响应，根本不会触发下载。唯一可靠路径是命令行离线安装：
-
code --install-extension必须使用绝对路径，Windows 要加双引号（如"C:\vsix\ms-python.python-2024.12.0.vsix"），Linux/macOS 不能用~/或相对路径 - 若提示
command not found: code，先在 VSCode 中按Ctrl+Shift+P运行Shell Command: Install 'code' command in PATH - 更新已有插件必须加
--force参数，否则命令直接跳过（例如：code --install-extension python.vsix --force） - 执行后不会自动重载窗口，需手动运行
Developer: Reload Window或重启 VSCode 才生效
插件版本与 VSCode 主版本必须严格匹配
私有云部署的 VSCode 版本（比如 1.92.2）和插件 engines.vscode 字段不一致时，会硬性报错 Extension is not compatible with Code，不是警告，无法跳过：
- 查看当前 VSCode 版本：Help → About → 记下
Version（如1.92.2）和架构（x64或arm64） - 插件必须从官方市场页面下载，URL 含插件 ID（如
https://marketplace.visualstudio.com/items?itemName=ms-python.python），点 “Download Extension” 按钮获取 .vsix —— 第三方网盘或 GitHub Release 页面的包可能签名失效或版本错配 - Python 插件 2024.12.0 要求 VSCode ≥1.90；若你用的是 1.89，则必须降级到 Python 插件 2024.8.0
语言类插件首次启用要预置 LSP 二进制
像 ms-python.python 这类插件，安装后默认启用，但第一次激活时会尝试下载 Pyright/Pylance 的 LSP 二进制包。私有云环境下这个步骤必然失败，表现为状态栏一直显示 Downloading，编辑器无响应：
- 这不是插件没装好，而是它卡在了离线不可达的子流程
- 解决办法：提前从同版本插件的 release 页面（如 GitHub 上
ms-python/python-language-server）下载对应架构的 LSP 包，解压后放入插件目录下的out/client/或dist/子目录（具体路径看插件文档） - 也可用
code --list-extensions --show-versions查出已安装插件 ID 和版本，再按 ID 逐个补全依赖
批量更新前先停掉同步与自动检查
私有云里开着 sync.autoDownload 或 extensions.autoCheckUpdates 会导致后台轮询超时、阻塞命令执行，甚至引发权限错误：
- 必须同时设为
false："extensions.autoUpdate": false和"extensions.autoCheckUpdates": false，仅关前者无效 - 检查是否被工作区配置覆盖：执行
Preferences: Open Workspace Settings (JSON)，确认没写入冲突项 - GitLens、ESLint 等插件自带更新通知，不走 VS Code 通用流程，需单独关其设置（如
gitlens.advanced.messages设为空数组） - 中文语言包（
vscode-language-pack-zh-hans）不受这些设置控制，它由 VS Code 主程序通过内网 product.json 同步，无需干预
真正麻烦的不是“怎么装”，而是“装完能不能跑”——LSP 预置、主版本对齐、路径权限、同步开关这四点漏掉任意一个，都会让更新看起来成功，实则功能残缺。建议把插件清单、VSIX 文件、LSP 二进制、settings.json 配置打包成一个可复现的部署单元，而不是单靠一条命令临时救火。
