离线安装插件≠立即可用，语言类插件首次启用会静默下载lsp/cli，需整目录迁移含pyright等依赖，并手动启用、彻底重启vscode验证。
离线安装插件 ≠ 插件立即可用，尤其是语言类、格式化类、远程类插件，首次启用时往往卡在后台静默下载环节——这不是失败，而是 VSCode 在离线状态下仍按在线逻辑执行了 LSP、CLI 或服务端组件拉取流程。
为什么装完插件没反应？常见卡点和验证方式
装完 ms-python.python 点开 .py 文件没语法高亮，或 esbenp.prettier-vscode 对 .vue 文件不生效，大概率不是安装失败，而是以下任一环节被阻断：
- 语言服务器（LSP）未就位：
ms-python.python首次启用会尝试下载pyright或python-language-server，离线时无提示、无报错、只显示“Starting Python Server…”并长期挂起 - 格式化器绑定未显式配置：仅安装
prettier-vscode不够，settings.json中必须有"[vue]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }，否则 Vetur 仍走自己的格式化路径 - 依赖 CLI 未预置：
prettier-vscode默认调用内置 CLI，但某些版本会尝试下载独立二进制；离线时该步骤静默跳过，导致保存时不触发格式化 - 插件状态为禁用：VSCode 离线安装后默认将插件设为
disabled，需手动点击「启用」或重启编辑器才真正加载
语言类插件（如 Python、TypeScript）离线首启实操
以 ms-python.python 为例，绕过首次 LSP 下载的可靠做法是复用已联网机器的完整插件目录：
- 在有网机器上打开任意
.py文件并保存一次，触发 LSP 下载完成 - 找到插件完整路径：
%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0\（Windows）或$HOME/.vscode/extensions/ms-python.python-2024.6.0/（macOS/Linux） - 整个文件夹（含
node_modules、dist、out及子目录下所有内容）拷贝到内网机对应路径 - 确保内网机 VSCode 已完全退出（任务管理器中确认无
Code.exe或Code Helper进程），再启动 - 首次打开
.py文件时，状态栏应显示 “Python interpreter selected”，而非 “Starting…”
Remote-SSH 插件离线连接失败的关键原因
装好 ms-vscode-remote.remote-ssh 后点连接，弹出错误 Failed to fetch commit ID 或卡在 Setting up SSH Host，本质是本地插件与远程 vscode-server 版本不匹配，而非插件本身问题：
- 先在内网 VSCode 中打开
Help → About，记下Commit ID（如a1859f34d7a7c259e33b423556529502890f5a3e） - 用该 ID 拼出 server 下载地址：
https://vscode.download.prss.microsoft.com/dbazure/download/stable/a1859f34d7a7c259e33b423556529502890f5a3e/vscode-server-linux-x64.tar.gz - 在跳板机下载后传入内网 Linux 服务器，解压到
~/.vscode-server/bin/a1859f34d7a7c259e33b423556529502890f5a3e/ - 确保该目录权限为当前用户可读写：
chmod -R u+rw ~/.vscode-server，否则连接时会报bad owner or permissions
容易被忽略的细节：插件启用时机与工作区依赖
拖拽 .vsix 成功安装后，插件图标可能灰显、右键菜单不出现、快捷键无效——这通常是因为插件未在当前上下文激活：
-
ms-python.python仅在打开含python.defaultInterpreter配置的工作区或项目根目录下才会激活 Python 支持 -
esbenp.prettier-vscode的格式化能力依赖.prettierrc或package.json中存在 Prettier 配置，否则即使启用也无效果 - 所有语言插件都要求工作区已加载（即至少打开一个文件夹），纯空窗口或欢迎页下插件处于休眠状态，不会响应任何事件
- 若插件含 native 二进制（如
pyright、esbuild），其架构（x64/arm64）必须与目标机器一致，混用会导致崩溃且无明确错误提示
