新手必看：命令行一键安装CodeGeex到VS Code

2026-06-23阅读 0热度 0

命令行工具

在 Ubuntu 系统里离线部署 CodeGeex 扩展，本质上就两个环节：拿到官方认证的 `.vsix` 文件，再用终端指令完成安装。然而多数人卡在第一关——要么下载了第三方修改版，要么文件路径掺杂中文导致安装无响应。下面把关键细节逐一讲透。

当你面对的机器无法访问 VS Code 扩展商店，或者需要批量部署到多台开发环境时，图形界面基本形同虚设——打开扩展面板只会看到“Unable to fetch extensions”的提示，搜索功能完全瘫痪。此时只能绕过 UI，直接用命令行加载本地的 `.vsix` 文件。 ## 获取官方认可的 CodeGeex .vsix 文件找一台能联网的设备，打开浏览器访问 VS Code 官方 Marketplace（直接搜“VS Code Marketplace”即可进入）。搜索 CodeGeex 后，在右侧「More Info」栏重点核对三项信息： - **发布者**：必须是 **Zhipu AI** - **标识符**：必须是 **aminer.codegeex** - **版本号**：≥ 2.6 确认无误后，点击「Download Extension」按钮，下载的文件名类似 `aminer.codegeex-2.6.0.vsix`。 ⚠️ 容易翻车的细节：如果下载的文件名里带有“CodeGeeX Pro”，或者发布者显示为“CodeGeeX Team”，说明你拿到的第三方修改版。这类版本安装后会缺失 `codegeex.localMode` 配置项，后续尝试启用离线模式直接报错，等于白费力气。 ## 将 .vsix 文件传输到 Ubuntu 脱机机拿到正版文件后，通过 U 盘拷贝或内网 SCP 传送到 Ubuntu 机器上。建议统一放在 `~/vsix/` 这类目录，方便管理。 **路径里绝对不能出现中文、空格或括号**。举个例子：文件放在 `/home/张三/下载/` 时，执行 `code --install-extension` 命令会直接解析失败——终端不报错，看起来一切正常，但扩展实际没装上。很多人在这里翻车，务必注意。 ## 执行命令行安装文件就位后，打开终端，切换到 `.vsix` 所在目录（也可以用绝对路径）。安装命令分两种情况： **情况一：VS Code 已加入系统 PATH** 一行搞定： ```bash code --install-extension aminer.codegeex-2.6.0.vsix ``` **情况二：提示 `command 'code' not found`** 先查 VS Code 的实际安装路径： ```bash ls /usr/share/code/ # 或 which code ``` 通常能找到 `/usr/share/code/bin/code`，然后用完整路径执行： ```bash /usr/share/code/bin/code --install-extension /home/yourname/vsix/aminer.codegeex-2.6.0.vsix ``` 命令跑完后，终端输出 `Extension 'aminer.codegeex' was successfully installed.` 即代表安装成功，重启 VS Code 验证即可。

新手必看：命令行一键安装CodeGeex到VS Code

相关阅读

最新教程

最新资讯