HBuilderX集成CodeGeex实战：高效提升Uni-app开发效率

在 Uni-app 项目中实时获取代码补全、注释生成、函数解释等 AI 辅助能力，必须确保 CodeGeeX 插件在 HBuilderX 中正确运行。官方要求的唯一安装路径是通过 HBuilderX 自带的插件通道，无法通过 VS Code 插件市场或 npm 手动安装。

确认 HBuilderX 版本兼容性

首先检查 IDE 版本号。打开 HBuilderX，进入「帮助」→「关于」即可查看。若版本低于 v4.10.0，CodeGeeX 插件无法加载，并会提示“插件不支持当前 IDE 版本”。版本过低时，建议前往 hx.dcloud.net.cn 下载最新标准版（2026年6月的 v5.07.2026041006 为当前稳定版）。旧版本强行安装会导致插件图标不显示、快捷键无响应、设置面板无法开启等一系列问题。

从官方渠道安装 CodeGeeX 插件

方法一：在线安装（新手推荐）
点击顶部菜单栏「工具」→「插件安装」，在弹出窗口切换到「在线插件」页签。搜索框中输入 CodeGeeX（注意拼写，区分大小写），找到官方发布的「CodeGeeX for HBuilderX」插件——作者为 dcloud，图标为蓝白齿轮加闪电。点击「安装」，等待进度条完成后，系统会提示“需重启 HBuilderX 生效”。关闭程序并重新启动即可。

方法二：离线安装（适合内网或受限环境）
访问 codegeex.cn/downloadGuide#hbuilder，下载与当前 HBuilderX 版本匹配的 .hbxplugin 文件。进入「工具」→「插件安装」→ 切换到「本地插件」页签 → 点击「选择文件」，选取刚下载的 .hbxplugin 文件 → 确认安装。此步骤后，必须重启 HBuilderX，否则插件不会正常加载。

登录并激活 CodeGeeX 服务

重启完成后，点击 HBuilderX 右下角状态栏的「CodeGeeX」图标（闪电符号），登录窗口会自动弹出。使用 codegeex.cn 官网注册的账号登录即可——未注册用户请先前往官网完成邮箱验证。登录成功后，插件会自动分配免费额度（新用户获赠 1000 次调用），界面右上角会显示绿色「已就绪」状态提示。此时打开任意 .vue 文件，在代码编辑区按 Ctrl+Enter（Windows）或 Cmd+Enter（macOS），即可触发代码补全面板。首次调用响应稍慢，后续请求基本稳定在 800ms 以内。

最后提醒一点：如果点击图标毫无反应，请检查是否误装了 VS Code 版插件包（.vsix 文件）。HBuilderX 仅识别 .hbxplugin 格式，这个细节务必留意。