离线安装vscode插件最稳路径是：联网机导出真实依赖树+拖拽安装为主+严格校验vscode版本；须手动构造官方vspackage链接下载匹配版本.vsix，用sha256sum校验，并同步安装隐式依赖。
科研人员在高校或研究所的内网环境里，基本没法直连 Marketplace，但又必须用 Python、LaTeX、Jupyter、GitLens 这类插件做论文写作和数据分析——离线安装不是“能装就行”，而是要确保功能完整、版本兼容、依赖不漏。实测下来，最稳路径是：用一台联网机器导出真实依赖树 + 拖拽安装为主 + 严格校验 VSCode 版本。
怎么拿到真正可用的 .vsix 文件（别信 Download Extension 按钮）
很多科研人员直接点插件页的“Download Extension”，结果装完发现 Jupyter 内核连不上、LaTeX 编译报错，根本原因是下载链接被缓存或跳转到了旧版。官方市场页面上的按钮只保证“能下”，不保证“是最新版”或“匹配你当前 VSCode”。
- 正确做法：打开插件页 URL，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python，在浏览器地址栏手动补全版本号参数，变成https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2024.6.0/vspackage—— 其中ms-python是 publisher，python是 extension_name（注意不是完整 ID），2024.6.0是你要的版本 - 版本怎么选？进插件页右下角看 “Requirements”，比如写 “VS Code >= 1.85”，而你内网机器上是
code --version输出1.84.2，那就得降级到2024.4.0（查 release note 确认兼容性） - 下载后立刻用
sha256sum python-2024.6.0.vsix校验，微软会在 GitHub Release 页面公布 SHA256 值（如ms-python/python仓库的v2024.6.0tag 下的checksums.txt）
为什么 code --install-extension 总失败（尤其在 Windows 内网）
命令行看似高效，但在科研内网场景下反而是最容易卡住的环节：路径错、签名拒、依赖缺、CLI 未注册——报错就一行 Command failed，根本看不出哪出问题。
-
code命令不可用？不是 PATH 问题，是 VSCode 没启用 Shell Command：启动 VSCode →Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 报
INVALID_SIGNATURE？离线环境无法连微软证书服务器，必须加--allow-unverified参数：code --install-extension C:/ext/ms-python.python-2024.6.0.vsix --allow-unverified - 装完列表里有、但 Jupyter 不识别内核？因为
ms-python.python强依赖ms-python.pylance和ms-python.debugpy，--list-extensions不显示隐式依赖，得去已配好环境的机器上运行code --list-extensions --show-versions > ext-full.txt，再逐个下载
拖拽安装为什么比图形界面“从 VSIX 安装…”更可靠
科研人员常在远程桌面（如 RDP、向日葵）或虚拟机里操作，图形界面点击“从 VSIX 安装…”容易因窗口焦点丢失、弹窗拦截、沙盒权限失败而静默失败；而拖拽是 VSCode 原生支持的协议级安装方式，绕过所有中间校验。
- 前提条件只有三个：VSCode 已启动、当前窗口有系统焦点（任务栏高亮）、已打开任意文件夹或空工作区
- 把
.vsix文件直接拖进编辑器主区域（不是侧边栏、不是设置页、不是终端面板），松手就会弹出确认框 - 失败常见原因：拖的是解压后的文件夹、文件名含中文或空格但没加引号、VSCode 版本低于插件要求的
engines.vscode字段值（这个字段藏在.vsix解压后package.json里）
LaTeX 和 Jupyter 插件的离线坑最多（科研刚需但依赖最杂）
这两个插件表面看是单个扩展，实际背后绑着一堆运行时依赖：LaTeX 需要本地 TeX 发行版 + latex-workshop + 可选的 ritwickdey.liveserver 预览；Jupyter 依赖 ms-toolsai.jupyter + ms-python.python + ms-python.pylance + 内核本身（如 ipykernel 要 pip install）。离线时最容易漏掉的是“非 VSCode 插件”的部分。
- LaTeX：先确认内网机器已装好 TeX Live 或 MiKTeX，再下载
James-Yu.latex-workshop的 .vsix，版本建议锁定8.32.0（2024 年底前最稳，对 VSCode 1.82+ 兼容性好） - Jupyter：不要只下
ms-toolsai.jupyter，必须同步下载ms-python.python和ms-python.pylance同一版本号（如都用2024.6.0），否则 kernel 列表为空 - 验证是否真生效：重启 VSCode 后，按
Ctrl+Shift+P输入Developer: Show Running Extensions，看ms-toolsai.jupyter状态是不是 “Active”，而不是 “Inactive (disabled)”
真正麻烦的从来不是“怎么装”，而是“装完以为好了，结果跑 notebook 时 kernel crash、编译 PDF 时找不到 xelatex、git commit 时中文乱码”——这些全是版本错配或依赖缺失的延迟报错。建议第一次离线部署时，用一台联网机器完整走一遍流程，导出 code --list-extensions --show-versions 和每个 .vsix 的 package.json 里的 extensionDependencies 字段，形成清单再批量搬运。
