macOS离线安装VS Code插件需使用.vsix文件，确保VS Code已启动并加载工作区、版本兼容且未被策略禁用；支持拖拽安装（最稳定）、命令行安装（code --install-extension）及手动复制解压后的扩展目录到~/.vscode/extensions/。
在 macos 上离线安装 vs code 插件，核心是用好 `.vsix` 文件，并确保环境满足几个关键条件：vs code 已启动并加载工作区、插件版本与本地 vs code 兼容、没被系统或企业策略禁用。整个过程不依赖网络，官方原生支持，不是临时 workaround。
下载正确的 .vsix 文件
先在有网的 Mac 或其他设备上获取可信、匹配版本的离线包：
- 打开 VS Code Marketplace，搜索目标插件（如 “Python”、“Prettier”）
- 进入插件详情页 → 右侧 Resources 区域点击 “Download Extension”，下载 `.vsix` 文件
- 建议重命名文件，带上插件 ID 和版本号（例如
ms-python.python-2024.6.0.vsix），方便后续核对 - 若已知本地 VS Code 版本（终端执行
code --version，取前两段如1.89.2→ 对应^1.89.0），可解压 `.vsix`（它本质是 zip）后打开package.json，检查"engines": {"vscode": "..."}是否兼容
拖拽安装（最稳、零配置）
这是 macOS 上成功率最高的方式，无需命令行或路径设置：
- 确保 VS Code 已启动，并至少打开了一个文件夹（哪怕空文件夹），不能停留在欢迎页
- 窗口需有焦点，且未处于全屏、远程连接状态；多显示器缩放异常时，尝试将 VS Code 拖到主屏再操作
- 直接把 `.vsix` 文件拖进编辑器主区域（就是写代码那块白色区域），松手会弹出确认框
- 点 “Install”，完成后插件默认为禁用状态，需手动点击启用按钮，或重启 VS Code
命令行安装（适合批量或脚本化）
适用于运维部署或一次装多个插件：
- 先确认
code命令可用：终端运行code --version，若提示 command not found，按Cmd+Shift+P输入 “Shell Command: Install ‘code’ command in PATH” 并执行 - 使用绝对路径安装：
code --install-extension /Users/yourname/Downloads/prettier-9.10.3.vsix - 如旧版已存在，加
--force覆盖：code --install-extension xxx.vsix --force - 安装后仍需手动启用插件，语言类插件（如 Python）首次启用还会尝试下载 LSP，离线会卡在 “Downloading…” —— 此时需提前在有网机器上完整触发过下载，再拷贝整个扩展文件夹
手动复制扩展目录（应急绕过限制）
当 GUI 和 CLI 都被组策略禁用，或插件含 native 二进制（如 Pyright、ESBuild）时适用：
- 解压 `.vsix` 文件，得到一个以
publisher.name-version命名的文件夹（如ms-python.python-2024.6.0/） - 将整个文件夹（含
node_modules、package.json等）复制到 macOS 的扩展目录：~/Library/Application Support/Code/User/globalStorage不对，正确路径是~/.vscode/extensions/ - 必须完全退出 VS Code（包括菜单栏右上角托盘图标），再重新打开，否则新扩展不生效
- 切勿只复制 `.vsix` 文件进去，也别把解压内容直接丢进 extensions 目录根层——目录结构必须严格保留
