命令行一键安装CodeGeex到VS Code指南

在 Ubuntu 离线环境下部署 CodeGeex 插件，整个流程浓缩为三步：获取官方 .vsix 安装包、传输至目标机器、通过命令行完成安装。每一步都有具体陷阱——例如路径中若包含中文或空格，安装命令会静默退出，表面无报错，实际扩展并未生效。

首先，获取正确的 .vsix 文件最为关键。在联网设备上打开 VS Code 官方 Marketplace，搜索 CodeGeex。列表中确认发布者为 Zhipu AI，标识符为 aminer.codegeex，版本号不低于 2.6。点击「Download Extension」下载，默认文件名形如 aminer.codegeex-2.6.0.vsix。需特别注意：若文件名包含"CodeGeeX Pro"或发布者显示"CodeGeeX Team"，即为第三方改造版本，安装后会缺失 codegeex.localMode 配置项，导致离线模式无法启用。

下载完成后，通过 U 盘或内网 SCP 将 .vsix 文件传输至 Ubuntu 离线主机。建议存放至 /home/yourname/vsix/ 这类无特殊字符的目录。路径中禁止出现中文、空格或括号，例如 /home/张三/下载/codegeex.vsix 会触发 code --install-extension 命令解析中断，终端无错误提示，但扩展实际未安装。

执行命令行安装

打开终端，切换到 .vsix 文件所在目录。随后运行安装指令：

code --install-extension aminer.codegeex-2.6.0.vsix

若 VS Code 已正确配置至系统 PATH，命令会正常执行。若终端输出 command 'code' not found，说明 PATH 未包含 code 二进制。此时需手动定位 VS Code 安装路径：

ls /usr/share/code/

或尝试 which code。常见路径为 /usr/share/code/bin/code。找到后用完整路径搭配 .vsix 文件绝对路径执行：

/usr/share/code/bin/code --install-extension /home/yourname/vsix/aminer.codegeex-2.6.0.vsix

安装成功的标志是终端最后一行显示：Extension 'aminer.codegeex' was successfully installed. 看到此行输出，才表示扩展已正确部署。