离线部署vs code必须准备三类文件：vs code主程序安装包（推荐system installer）、.vsix插件包（须从官方市场页下载）、vscode-server二进制包（仅remote场景需，版本须严格匹配）。缺一不可。
要下载哪些文件，缺一不可
离线部署 VS Code 不是只下个 Code.exe 就完事。你必须准备三类资源，漏掉任何一类，后续安装或运行都会卡住：
-
VS Code 主程序安装包（.exe或.zip），推荐 System Installer（需管理员权限）用于企业统一部署；.zip版适合受限用户或便携场景 -
.vsix插件包 —— 必须从官方插件市场页点击Download Extension按钮获取，不是 GitHub Release、不是第三方镜像、也不是浏览器插件生成的链接 -
vscode-server二进制包（仅当使用 Remote-WSL / Remote-SSH 时需要），它和本地 VS Code 客户端版本严格绑定，不能靠“猜”或“差不多”
怎么拿到真正能用的 .vsix 文件
90% 的离线安装失败，根源在 .vsix 文件本身不匹配。关键不是“有没有”，而是“对不对”：
- 打开插件市场页，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python，点右侧Download Extension—— 这个按钮生成的是带签名、有时效、含平台标识的直链，版本和签名都对得上 - 若需批量或指定历史版本，用 API 拼 URL：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中{publisher}是ms-python，{extension_name}是python，{version}必须和 Version History 里完全一致（如2026.6.123456） - 下载后立即重命名，加入版本号和平台信息，例如
python-2026.6.123456-win32-x64.vsix，避免混用导致INVALID_SIGNATURE或静默失败
vscode-server 怎么离线部署才不报错
Remote 功能连不上，大概率是因为远端缺 vscode-server。它不会随插件一起装，也不能手动解压到任意位置：
- 先在有网机器上用相同版本的 VS Code 客户端连一次目标环境（如 WSL），触发自动下载；成功后，去远端找路径：
~/.vscode-server/bin/<commit-id></commit-id>（<commit-id></commit-id>是客户端code --version输出的第二段哈希值） - 把整个
<commit-id></commit-id>目录打包（含bin、dist、node_modules等子目录），复制到内网机器对应路径下 - 确保远端用户主目录权限正确（
chmod -R 755 ~/.vscode-server），且~/.vscode-server/data/Machine目录存在（若无，手动创建）
容易被忽略但致命的细节
这些点不显眼，但一旦出错，你会花几小时排查一个根本不存在的问题：
-
code命令不可用？不是 PATH 没配好，而是 VS Code 根本没启用 Shell Command：在 VS Code 里按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 路径含中文或空格（如
C:\用户\张三\vsix\）会导致code --install-extension静默失败；Windows 下务必用纯英文路径，并用正斜杠写法：code --install-extension "C:/vsix/python.vsix" - 装完插件后不生效？不是没装上，而是 VS Code 进程还在后台跑 —— Windows 下要进任务管理器结束所有
Code.exe，包括托盘里的隐藏进程，否则扩展目录缓存不刷新
