code --install-extension 必须用绝对路径,相对路径在多数终端中会失败;需先确认 code 命令可用(code --version),安装后插件默认禁用,须手动启用或重启 VS Code。

code --install-extension 必须用绝对路径
相对路径在多数终端里会失败,尤其当你不是从 VS Code 启动终端、或当前工作目录和 .vsix 不在同一层时。code --install-extension plugin.vsix 看似简洁,但极大概率报 ENOENT 或静默无反应。VS Code CLI 不做路径补全,只认完整路径。
实操建议:
- Linux/macOS:用
pwd确认当前目录,然后写成code --install-extension $(pwd)/prettier-3.2.5.vsix或直接code --install-extension /home/user/ext/prettier-3.2.5.vsix - Windows:路径含空格或中文必须加双引号,推荐正斜杠避免转义问题:
code --install-extension "C:/ext/vscode-eslint-2.4.0.vsix" - 每条命令最多支持 10 个
--install-extension,超了就分批,别堆一起
安装前必须确认 code 命令可用
code --version 返回版本号是前提。很多用户执行 code --install-extension 报 command not found,根本原因不是插件问题,而是 VS Code 的 Shell Command 没启用。
解决方法:
- 打开 VS Code →
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 重启终端(不是 VS Code),再试
code --version - Conda 环境下可能需先
source ~/.bashrc或conda init
安装后插件默认禁用,且不自动重启
命令行安装成功只代表文件已复制进 ~/.vscode/extensions/,不会触发启用逻辑。你不会看到弹窗、也不会自动激活功能——这是设计行为,不是 bug。
常见后果:
- 扩展面板里显示 “已安装”,但右上角是灰色的
Enable按钮 - 按
Ctrl+Shift+P输插件命令,提示 “command not found” - 语言插件(如 Python、Rust)不触发语法高亮或 LSP 启动
必须手动操作:在扩展面板搜索该插件 → 点击右侧 Enable → 或完全退出 VS Code(包括托盘进程)再重开。
失败时看错误信息,别猜
code --install-extension 失败会明确输出原因,比图形界面友好得多。关键错误类型就几个:
-
Unable to install extension 'ms-python.python' as it is not compatible with VS Code '1.79.2'→ 打开插件解压后的package.json,检查"engines": { "vscode": "^1.80.0" },升级 VS Code 或换低版本插件 -
Error: EACCES: permission denied, open '/home/user/.vscode/extensions/...'→ 先chmod 644 your-plugin.vsix,再重试 -
Extension is not a valid VS Code extension→ 用unzip -t your-plugin.vsix校验压缩包是否损坏;也可能是被杀毒软件截断或浏览器改了后缀(比如变成.vsix.zip)
真正难搞的不是安装失败,而是装完没报错却没生效——这时要立刻打开 Developer Tools(Ctrl+Shift+P → Developer: Toggle Developer Tools),看 Console 里有没有 activation failed 或 Extension host terminated。


















