离线安装VSCode插件前须先确认插件ID（如ms-python.python）和精确版本号（如2024.10.1），否则易报兼容性错误；推荐通过官方API构造下载链接：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension}/{version}/vspackage，并用code --install-extension命令行安装。
离线安装 VSCode 插件前，先确认插件 ID 和版本号
直接在 VSCode 里点“下载扩展”会失败，因为离线环境无法访问 marketplace.visualstudio.com。必须提前在线获取插件的 publisher.id（比如 ms-python.python）和精确版本号（如 2024.10.1），否则离线安装时会报 Extension is not compatible with current version of VS Code 或 Unable to read extension package。
实操建议：
- 在线机器上打开 VSCode → 进入插件页 → 搜索目标插件 → 点击右上角「…」→ 选择「Copy Extension ID」
- 访问
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ 查看 URL 中的版本参数或页面底部「Version History」链接 → 找到与你 VSCode 版本匹配的 .vsix 文件名（例如python-2024.10.1.vsix） - VSCode 版本需严格对应：用
code --version查看本地版本（如1.92.2），再比对插件支持的engines.vscode范围（常见于插件package.json中）
从 Marketplace 下载 .vsix 文件的可靠方式
别用浏览器右键另存为——页面上的“Download Extension”按钮实际是 JS 触发跳转，离线抓包或复制链接容易失效。正确路径是构造官方下载地址。
实操建议：
- 格式为：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension}/{version}/vspackage - 例如下载
ms-python.python@2024.10.1：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2024.10.1/vspackage - 用
wget或浏览器访问该链接，保存为python-2024.10.1.vsix（注意后缀必须是.vsix，不能是.vspackage） - 某些插件含多个平台二进制（如
ms-vscode.cpptools），需额外下载对应平台的-win32-x64.vsix等变体，否则安装后功能缺失
离线安装 .vsix 时命令行比 GUI 更可靠
VSCode GUI 的「Install from VSIX…」偶尔因缓存或权限失败，尤其在企业锁屏或无管理员权限的终端上。命令行可明确反馈错误类型，也支持批量安装。
实操建议：
- 确保 VSCode 已关闭（否则提示
Cannot modify user settings while Code is running） - 执行：
code --install-extension /path/to/python-2024.10.1.vsix - 若提示
ENOENT，检查路径是否含中文或空格；若提示EACCES，加--user-data-dir指向可写目录（如code --user-data-dir=/tmp/vscode-test --install-extension ...） - 安装多个插件时，逐条执行命令，不要用
&&连接——某个失败会导致后续跳过
依赖插件未预装会导致离线安装静默失败
很多插件（如 ms-python.pylint、ms-python.flake8）依赖 ms-python.python 作为前置平台。但 VSCode 不会在离线安装时提示「缺少依赖」，而是直接停在「Installing…」不动或闪退。
实操建议：
- 安装前查清依赖链：打开插件页面 → 「Dependencies」标签页 → 记录所有
extension类型依赖项 - 按依赖顺序安装：先装
ms-python.python，再装ms-python.pylint，最后装ms-python.black-formatter - 验证是否生效：安装后启动 VSCode，运行
code --list-extensions，确认所有 ID 都在输出中；再打开设置搜索python.defaultInterpreter，能出现即说明核心插件已加载
最易被忽略的是插件内置的二进制工具（如 pylint、mypy）——它们不随 .vsix 自动部署，需单独下载并配置 python.linting.pylintPath 等路径。这部分没网络就真没法自动补全。
