离线安装VSCode插件功能失效主因是语言服务依赖未下载；需在有网机预触发下载后，完整拷贝扩展目录（含node_modules）至内网机对应路径，而非仅传.vsix文件。
离线安装 VSCode 插件本身不难，难的是装完后 Python 补全、Prettier 格式化、ESLint 报错提示等功能全部失效——这几乎 100% 是因为语言类插件的 native 依赖（如 pyright、prettier CLI）没拉下来，而不是插件没装上。
拖.vsix进VSCode窗口没反应？先确认这三件事
这是内网最常被误判为“安装失败”的场景，实际只是触发条件没满足：
- VSCode 必须已加载一个工作区（哪怕只打开一个空文件夹），纯启动页或远程连接未就绪时拖放无效
- 窗口必须获得系统焦点：任务栏图标高亮、鼠标能正常点击编辑区；全屏/远程桌面（如 RDP）会拦截拖放事件
- 拖的是原始
.vsix文件，不是解压后的文件夹，也不是被浏览器重命名成.vsix.zip的损坏包
code --install-extension 报 “not compatible with Code” 怎么快速定位
这个错误和网络无关，只和版本号硬匹配有关。VSCode 安装时会严格比对 .vsix 包里 package.json 中的 "engines": {"vscode": "^1.85.0"} 和你本地 code --version 输出的第一段（如 1.90.2 → 取 1.90）。
- 用
unzip -l your-extension.vsix查看包结构，确认顶层有extension/package.json - 解压后打开
package.json，直接看engines.vscode字段，别信插件页面写的“支持最新版” - ARM Mac 装了 x64 版本的插件（尤其含
pyright、esbuild的），也会报同一错误，需找带darwin-arm64标识的版本
装上了但 Python 补全不生效？问题不在插件本身
语言类插件（如 ms-python.python、esbenp.prettier-vscode）首次启用时，默认会从外网下载 language server 或 CLI 工具。离线环境下它不会报错，只会卡在状态栏显示 “Downloading…” 或输出面板里刷 Failed to fetch。
- 解决方案不是重装
.vsix，而是提前在有网机器上完整跑一遍：打开一个.py文件 → 等状态栏变绿 → 再把整个扩展目录（如~/.vscode/extensions/ms-python.python-2024.6.0/）拷到内网机对应路径 - 不能只拷
.vsix文件，也不能只拷node_modules；必须是解压后带package.json+node_modules+dist的完整文件夹 - 拷完要彻底退出 VSCode（Windows 检查系统托盘、macOS 查 Activity Monitor），否则缓存不刷新
企业环境批量部署时，--extensions-dir 是关键变量
很多内网机器是便携版、多用户共用，或被策略限制写入默认 extensions 目录。这时靠 code --install-extension 默认路径会静默失败。
- 用
code --extensions-dir /path/to/shared-extensions --install-extension /path/to/xxx.vsix指定自定义路径，绕过权限问题 - 路径必须存在且可写，建议提前
mkdir -p并验证touch权限 - 启动 VSCode 时加
--extensions-dir参数，或在settings.json里配"extensions.autoUpdate": false防止后续自动覆盖
离线插件最隐蔽的坑，是版本兼容性不报错、依赖缺失不提醒、安装成功却功能静默失效——所有这些都发生在你关掉终端、合上笔记本之后。验证是否真可用，唯一可靠方式是打开对应文件类型，调出命令面板搜插件命令，再盯一眼输出面板的实际日志。
