code --install-extension 命令必须用绝对路径，相对路径基本无效；含空格或中文路径需加英文引号；拖拽失效主因是未加载工作区、无窗口焦点或文件非原始.vsix；语言插件离线需手动部署lsp服务器。
code --install-extension 命令必须用绝对路径
相对路径在终端里基本等于无效，VSCode CLI 不做任何路径补全或自动解析。执行后没报错、没提示、插件也不出现，大概率是根本没读到文件。
常见写法错误：
-
./python.vsix→ Linux/macOS 下几乎必失败 -
C:\ext\python.vsix→ Windows 反斜杠需双写，否则被当转义符 -
/mnt/backup/my plugin.vsix→ 含空格未加引号，直接截断
正确写法示例：
- Linux/macOS：
code --install-extension /home/user/ext/ms-python.python-2024.6.0.vsix - Windows（推荐正斜杠）：
code --install-extension C:/ext/prettier-9.10.3.vsix - 含空格或中文：
code --install-extension "/mnt/backup/Python 插件.vsix"
拖拽 .vsix 没反应？先确认三件事
这不是插件坏了，而是 VSCode 拒绝响应——它只在特定环境状态下接受拖放。
- VSCode 必须已加载一个工作区：纯启动页、远程 SSH 未连接完成、或空编辑器窗口，拖放会被静默忽略
- 窗口必须有系统焦点：任务栏图标未高亮、鼠标悬停无反应，就说明没焦点；点一下编辑区再试
- 拖的是原始
.vsix文件：不能是解压后的文件夹、.zip、双后缀（如prettier.vsix.zip），更不能是右键重命名生成的损坏包
验证是否为有效 .vsix：
unzip -l your-extension.vsix 应显示顶层目录为 extension/，且含 extension/package.json；若报错或结构散乱，说明文件已损坏。
插件显示“已安装”但 Python/ESLint 补全不工作
这是离线环境最典型的假成功。VSCode 安装 .vsix 只是把代码复制进去，而语言类插件（如 ms-python.python、dbaeumer.vscode-eslint）首次启用时会自动下载 LSP 服务器（如 pyright、eslint-language-server）——这些二进制工具默认走外网，离线就卡住或静默失败。
典型现象：
- 状态栏卡在
Downloading pyright... - Output 面板切换到
Python或ESLint，看到Failed to fetch或spawn ENOENT
正确做法：
- 提前在有网机器上，用同版本、同架构（x64/arm64）的 VSCode 打开一次对应类型文件（如
.py），等 LSP 下载完成、状态栏变绿 - 然后完整拷贝整个扩展目录（如
~/.vscode/extensions/ms-python.python-2024.6.0/）到离线机对应路径
批量部署时漏掉依赖插件怎么办
单个插件手动装没问题，但团队批量部署靠人肉下载，极易漏掉隐式依赖。比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化功能直接失效。
别信插件页面写的“Recommended”，真实依赖藏在 .vsix 解压后的 package.json 的 extensionDependencies 字段里。
最稳方式：
- 在已配好的联网机器上导出完整列表：
code --list-extensions > extensions.txt - 逐行用
vsce download下载对应.vsix：vsce download ms-python.python@2024.6.0 - 注意：必须带
@version，否则可能下到旧版；vsce工具需提前全局安装：npm install -g @vscode/vsce
版本兼容性、签名验证、LSP 二进制缓存——这三项不手动对齐，离线安装就只是把代码放进去，不是让插件真正跑起来。
