离线安装vscode必须用system installer并勾选add to path和右键菜单选项，否则code命令失效；首次启动需禁用自动更新和扩展检查，拖拽.vsix至编辑区安装后须手动启用。
离线安装 VSCode 不是“凑合用”，而是必须选对安装包、勾对选项、绕过首次联网卡点，否则装完就卡在“正在加载扩展”或 code --install-extension 报错。
必须用 System Installer（.exe），别碰 User Installer 和 .zip
VS Code 全量包在内网语境下特指 VSCodeSetup-x64.exe（Windows）或 VSCode-darwin-universal.zip（macOS）这类带自包含运行时的安装器。User Installer 虽然也是 .exe，但它只写当前用户目录，不注册右键菜单、不配 PATH、不写系统级图标缓存；.zip 版解压即用，但连 code 命令都不存在，后续所有插件命令和脚本化部署都会断掉。
- 去官网下载页明确找 System Installer 链接，不是“User Installer”也不是“Zip Archive”
- 双击运行后，在最后一页安装确认前，务必勾选两项：
Add to PATH和Add "Open with Code" action to Windows Explorer context menu - 漏选任一，重装比手动修注册表或 PATH 更快——Windows 下 PATH 注册依赖安装器以管理员权限调用的 COM 接口，非提权运行无法补救
安装后第一件事：验证 code CLI 是否真就绪
别急着装插件。打开 PowerShell 或 CMD，直接执行：
code --version
如果返回类似 1.89.2 的版本号，说明 CLI 已生效；若提示 command not found: code，不要尝试手动往 PATH 里加路径——那是无效的。唯一可靠做法是重装，并确保上一步勾选了 Add to PATH。
- 该命令失败几乎 100% 是安装时未勾选或没用管理员权限运行安装器
- 即使你看到“安装成功”弹窗，只要没重启终端，PATH 变更也不会生效——这是 Windows Shell 的机制，不是 VSCode 的 bug
- 验证通过后，再执行
code --install-extension才有意义
首次启动必须关联网行为，否则卡死在“Downloading…”
哪怕你什么插件都没装，VS Code 首次启动也会尝试拉取 ms-vscode.vscode-typescript-next 等内置语言服务、检查更新、甚至下载中文语言包。离线环境下这些请求会超时重试，导致编辑器响应迟钝、状态栏长期显示“Starting…”、某些插件面板空白。
- 启动后立刻按
Ctrl+Shift+P，输入Preferences: Open Settings (JSON)回车 - 在打开的
settings.json中添加两行（已有同名字段则覆盖）：
"extensions.autoUpdate": false, "update.mode": "none"
- 保存后重启 VS Code——这步不能跳，配置需重载才生效
- 不加这两项，
ms-python.python会卡在 “Downloading Pylance…”；volarjs.volar会卡在 “Initializing Volar server…”；不是插件坏了，是它在等一个永远不会回来的响应
离线装插件，拖 .vsix 比命令行更稳
code --install-extension 对路径、权限、进程状态极其敏感，而拖拽 .vsix 文件到主编辑区是 VSCode 官方支持的离线安装通道，不走 CLI、不校验签名、不触发任何网络请求。
- 确保 VS Code 已启动，并打开了任意文件夹（哪怕空的），窗口有焦点、未全屏、未连接远程 SSH
- 把未解压的
python-2026.6.123456.vsix直接拖进中间代码编辑区域（不是侧边栏、不是设置页），松手即弹出安装确认 - 安装完成后，插件默认是禁用状态——必须手动点击「启用」，或彻底退出 VS Code（任务管理器里确认无
Code.exe进程）再重开 - 如果拖进去没反应，先看右下角状态栏是否显示
Extensions disabled by policy——这是企业组策略禁用了扩展安装，GUI 和 CLI 都会失效
真正难的从来不是“怎么装”，而是语言类插件首次启用时静默下载 LSP 二进制。那部分没法靠 .vsix 解决，必须提前在有网机器上触发完整加载，再整目录迁移 ms-python.python-2026.6.0/ 这类带 node_modules 和原生二进制的文件夹。
