最稳的离线安装方式是拖拽.vsix文件至已加载工作区的vscode主编辑区，需满足vscode运行、有焦点、非空白页三条件；若失败，常见原因为未加载工作区、无系统焦点、全屏/远程环境拦截或文件非原始.vsix。
最稳的快捷方式是把 .vsix 文件直接拖进已加载工作区的 VSCode 主编辑窗口——只要 VSCode 正在运行、有焦点、且不是空白启动页，松手就会弹出安装确认框，全程不依赖网络、不调用命令行、也不需要打开扩展面板。
拖拽安装为什么有时没反应
这不是插件问题，而是 VSCode 对拖放事件有严格触发条件：
- VSCode 必须已加载一个工作区（哪怕只是打开一个空文件夹），纯启动页或远程 SSH 连接未就绪时不响应
- 窗口必须获得系统焦点：任务栏图标未高亮、鼠标悬停无反应，就说明没焦点，点一下编辑区再试
- 全屏模式、RDP/TeamViewer 等远程桌面会拦截拖放事件，退出全屏或换本地操作
- 别拖解压后的文件夹或重命名过的
.zip，用unzip -l xxx.vsix确认顶层是extension/目录
code --install-extension 命令必须满足的硬条件
这个命令看似简单，但离线环境下失败几乎都卡在路径和环境配置上：
VSCode 1.118
下载
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
-
code命令必须可用：终端运行code --version，若报错就先在 VSCode 里按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH启用 - 路径必须是绝对路径：Windows 推荐正斜杠写法
code --install-extension C:/ext/python-2024.6.0.vsix；含空格或中文时加英文双引号：code --install-extension "C:\my ext\prettier.vsix" - 不能用插件 ID：
code --install-extension ms-python.python在离线环境必报connect ECONNREFUSED - 安装后不会立即生效：需重启 VSCode 或执行
Developer: Reload Window
插件显示“已安装”但功能不生效怎么办
这是离线环境最典型的假成功——VSCode 只装了前端代码，没拉语言服务器或 CLI 工具：
- 打开一个
.py文件，看状态栏是否卡在Downloading pyright；或者打开View → Output，切换到Python面板，查Failed to fetch或spawn ENOENT - 正确做法：提前在有网机器上用同版本、同架构（x64/arm64）的 VSCode 安装插件，并打开一次对应文件类型，等下载完成、状态栏变绿，再把整个
%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0文件夹拷过去 - 手动复制
.vsix到extensions目录下无效——VSCode 不会自动解压，必须通过code --install-extension或拖拽触发解压流程
版本兼容性是离线安装的第一道门槛，所有报错里超过 90% 都是 Extension is not compatible with Code；而功能失效的根源，往往不在插件本身，而在它背后那些没被一起带进来的二进制依赖。
