VSCode怎么用脚本自动安装.vsix插件文件-VSCode-PHP中文网

code --install-extension 是唯一可靠的VS Code命令行安装方式，仅校验包结构和vscode版本兼容性，需用绝对路径、--force参数及timeout兜底，安装后须检查禁用状态并重启。

vscode怎么用脚本自动安装.vsix插件文件

code --install-extension 是唯一可靠的命令行入口

VS Code 官方只支持 code --install-extension 安装本地 .vsix 文件，它不走网络、不调 Marketplace API，只校验包结构和 package.json 中的 engines.vscode 字段。其他方式（如直接复制文件夹）属于底层绕过，易因目录名错误或缓存未刷新而失效。

必须用绝对路径：code --install-extension /home/user/ext/prettier-3.2.5.vsix（Linux/macOS）或 code --install-extension C:/ext/eslint-2.4.0.vsix（Windows，推荐正斜杠）。相对路径在非 VS Code 启动的终端中大概率失败。

每条命令最多支持 10 个 --install-extension 参数，超了要分批，否则静默截断
失败时会明确输出错误，例如 Unable to install extension 'esbenp.prettier-vscode' as it is not compatible with VS Code '1.79.2'
安装后插件默认禁用，尤其含 "workspace" 或 "terminal" 权限声明的插件，需手动启用或重启 VS Code

脚本里必须先探测 code 命令是否可用

code 不是系统自带命令，它的存在依赖用户是否执行过 Shell Command: Install 'code' command in PATH。实测常见失效场景包括：macOS 通过 .dmg 安装但没运行过 GUI、Linux Snap 版本默认无 code、Windows PowerShell 中 code 是函数而非可执行文件。

脚本开头应加探测逻辑：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

if ! command -v code > /dev/null; then
  echo "error: code command not found"
  exit 1
fi

Linux Snap 用户可手动创建符号链接：sudo ln -s /snap/code/current/usr/share/code/bin/code /usr/local/bin/code
Windows Git Bash 下若 code 不识别，改用 cmd /c "code --install-extension ..."
不要依赖 set -e 全局中断，单个插件失败不该阻断整个流程

批量安装要加 timeout 和退出码判断

code --install-extension 默认无超时，遇到签名校验卡住（如企业内网无法连微软证书服务器）、或插件包损坏，会无限等待。脚本必须为每个安装加兜底：

用 timeout 60s code --install-extension "$file" --force 限制单次操作时长
检查 $?：0 表示成功；1 表示明确失败（版本不兼容、签名无效等）；非 0 非 1 通常是 timeout 发送的 SIGTERM
对失败项记录到 failed-install.log，内容包含文件路径和错误时间，方便后续人工重试
--force 必须加上，否则已存在同 ID 插件时会跳过，导致版本固化失败

装完不生效？重点查 extensions.json 和工作区禁用状态

离线安装后插件“看不见”或“点不动”，往往不是安装失败，而是环境配置没对齐：

打开 $HOME/.config/Code/User/extensions.json（Linux）或 %APPDATA%\Code\User\extensions.json（Windows），确认刚装的插件 ID 是否出现在 disabledExtensions 数组里——这是真实禁用清单，code --list-extensions 不会显示它
按 Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools → 看 Console 是否有 activation failed 或 Extension host terminated
右下角齿轮图标 → Extensions → 搜索插件名 → 看右上角是否显示 Disable (Workspace)，这是工作区级禁用，比全局设置优先级更高
某些插件（如 bradlc.vscode-tailwindcss）依赖其他插件才能激活，得先装 esbenp.prettier-vscode 才能格式化 Tailwind 类名

最常被忽略的是：安装后没完全退出 VS Code（托盘进程还在），导致扩展缓存未刷新，重启前看不到新插件。