code --install-extension 能装上不代表插件可用，主因是版本不匹配、依赖未满足或文件损坏；拖拽失效常因未加载工作区、无窗口焦点或非原始.vsix文件。
code --install-extension 命令能装上，不代表插件真能用；离线安装失败的主因不是操作不对，而是版本不匹配、依赖没补全、或文件被静默损坏——这些在拖拽时几乎不报错，但功能全失效。
拖进 VSCode 主窗口没反应？先确认三个硬条件
这是离线场景下最常误判为“安装失败”的情况，实际是环境没达标：
- VSCode 必须已加载工作区（空白窗口或远程 SSH 状态下拖放会静默忽略）
- 窗口必须有系统焦点（任务栏图标高亮，且没处于全屏模式）
- 拖的是原始
.vsix文件，不是解压后的文件夹、.zip或双后缀文件（如prettier.vsix.zip）
验证方法：用 unzip -l xxx.vsix 查看顶层目录是否含 extension/package.json。若报错或显示一堆零散文件，说明文件已损坏或被错误重命名。
code --install-extension 报 “not compatible with Code” 怎么查根源
这个错误只说明版本不兼容，但不会告诉你具体哪一环不匹配。需手动比对三处：
- 运行
code --version，取输出中第一位小数点前的版本号（如1.85.2→1.85） - 解压
.vsix，打开extension/package.json，找"engines": {"vscode": "^1.80.0"}字段 - 检查架构：Help → About 里括号中的
arm64/x64是否与插件构建目标一致（ARM Mac 装 x64 插件会卡在 native 二进制加载）
注意：^1.80.0 表示最低支持 1.80.0，你用 1.79.2 就会被跳过——不报错、不提示，只是不加载。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
插件装上了但 Python/ESLint 功能不生效？大概率缺 LSP 服务器
像 ms-python.python、dbaeumer.vscode-eslint 这类语言插件，离线安装后首次打开 .py 或 .js 文件时，会尝试下载 pyright、eslint CLI 等二进制依赖，默认走外网，结果状态栏一直显示 “Downloading…”。
- 正确做法：在有网机器上先完整启用一次该插件（打开对应文件类型→等下载完成→关机前别卸载）
- 然后拷整个插件目录（如
ms-python.python-2024.6.0/）到内网机器的~/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows） - 不能只拷
.vsix，也不能只拷node_modules—— native 二进制（如pyright-server）藏在子目录里，漏一个就启动失败
验证方式：打开 Output 面板（View → Output），切换到对应插件通道（如 Python），看是否有 spawn ENOENT 或 Failed to fetch。
手动复制到 extensions 目录为什么还是识别不到
VSCode 启动时靠目录名识别插件，不是靠内容校验。手动复制必须严格满足命名规范：
- 先用
unzip -p xxx.vsix extension/package.json | grep id提取扩展 ID（如"id": "ms-python.python"） - 再看
unzip -l xxx.vsix输出的第一行目录名（如ms-python.python-2024.6.0/）——这个就是你要创建的子目录名 - 把整个解压后的同名目录复制进用户
extensions路径，不能只复制里面的内容，也不能保留.vsix文件本身 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，新目录被忽略
最容易被忽略的一点：企业版或策略锁定的 VSCode 可能禁用所有未签名插件，现象是安装后重启就自动消失，日志里出现 Extension 'xxx' is not signed —— 此时只能换官方市场下载的原版 .vsix，别用 GitHub Release 或第三方打包源。
