code --install-extension 批量安装最可靠：需将 code 加入 PATH，每个 .vsix 单独用 --install-extension 参数指定绝对路径（含空格需英文双引号），安装前关闭所有 VSCode 进程。
用 code --install-extension 批量安装最可靠
图形界面点“从 VSIX 安装…”在装多个插件时容易卡死或静默失败，尤其内网机器资源有限时。命令行是唯一能脚本化、可复现、可批量管理的方式。
关键不是“能不能执行”，而是路径和参数写法必须严格符合规则：
-
code命令必须已加入系统 PATH（Windows 可在 VSCode 里按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH启用） - 每个插件都得单独写一个
--install-extension参数，不能合并：
✅ 正确：code --install-extension "/path/a.vsix" --install-extension "/path/b.vsix"
❌ 错误：code --install-extension "/path/a.vsix" "/path/b.vsix" - 路径必须是绝对路径；含空格或中文时，必须用英文双引号包裹：
"C:/my tools/python-2024.6.0.vsix" - 执行前关掉所有 VSCode 进程（包括托盘后台），否则部分插件可能只注册不加载
拖放 .vsix 文件没反应？先检查这三点
不是插件坏了，是 VSCode 根本没收到安装信号。常见于远程桌面（RDP/TeamViewer）、全屏模式或窗口失焦场景。
- VSCode 必须有系统焦点（任务栏图标高亮）
- 拖入的必须是未解压的原始
.vsix文件（可用unzip -l xxx.vsix确认顶层含extension/目录） - VSCode 版本 ≥ 插件
package.json中engines.vscode声明的最低版本（比如插件要求^1.85.0，你装的是1.79.2就会静默跳过）
装上了但 ESLint/Vue/Python 不生效？语言服务器根本没落地
很多插件（如 ms-python.python、esbenp.prettier-vscode、volarjs.volar）只靠 .vsix 文件只能注册前端 UI，首次打开对应文件类型（.py、.vue、.ts）时才会拉取语言服务器（LSP server）——离线环境直接卡在 “Downloading…”。
- 正确做法：在有网机器上完整触发一次——打开一个
.py文件 → 等状态栏显示 “Python Language Server: Ready” → 再把整个扩展目录拷到内网机对应路径下 - Linux/macOS 路径：
~/.vscode/extensions/ms-python.python-2024.6.0/
Windows 路径：%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.6.0\ - 必须拷完整目录（含
node_modules和二进制可执行文件如pyright-server），只拷.vsix文件等于白装 - 复制完要彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，新插件不会激活
ARM Mac 或 Windows on ARM 装不上？架构不匹配不报错，只丢功能
VSCode 不会提示 “架构错误”，而是静默跳过 native 模块加载，结果就是语法高亮正常、但跳转/补全/诊断全失效。
- 先确认本地架构：
code --version或 Help → About 查看显示的是x64还是arm64 - 再查
.vsix解压后package.json是否声明了对应平台构建，比如darwin-arm64、win32-arm64 - 含 LSP server 的插件（如 Volar、Pyright）务必从 GitHub Release 页面下载带平台后缀的版本，别只认版本号
