HBuilderX+CodeGeex：Uni-app开发安装配置实战指南

要在 HBuilderX 中借助 CodeGeex 提升 Uni-app 开发效率，必须先确认 CodeGeex 是否兼容你当前的开发环境。

直接给结论：截至 2026 年 6 月，CodeGeex 官方未推出 HBuilderX 原生插件，其官方支持范围仍锁定在 VS Code 与 JetBrains 系列 IDE。在 HBuilderX 插件市场搜索“CodeGeex”不会有任何结果。若尝试强制拖入 .vsix 文件，大概率直接闪退。

确认 CodeGeex 是否兼容 HBuilderX

用事实说话。打开 HBuilderX，点击「工具」→「插件市场」，在搜索框键入“CodeGeex”，回车。

结果为空列表，零匹配。这已经说明问题——CodeGeex 目前不提供 HBuilderX 插件，也不兼容其插件体系。

HBuilderX 采用自研插件架构（基于 HTML+JS+Node.js 沙箱），与 VS Code 的 .vsix 扩展机制完全不同。强制拖入只会弹出“插件格式错误”提醒，无法安装。

替代方案：在 HBuilderX 中调用外部 CodeGeex Web 版

既然无法直接安装，仍有两条曲线救国路径。

方法一：通过浏览器侧边栏嵌入

在 HBuilderX 中按 Ctrl+Shift+I 打开开发者工具，切换到 Console 面板，粘贴并执行以下脚本：

fetch('https://www.php.cn/link/04a8ccbcb420e48b1165dffb899ebda8/api/v1/status').then(r => r.json()).then(console.log)

若返回 {status: "online"}，代表 Web API 可用；否则需手动前往 CodeGeex 官网查阅最新接入方式。

方法二：通过快捷键唤起本地 CodeGeex 客户端（需先安装）

前提是已安装 CodeGeex Desktop v2.4.0 及以上版本（支持 Windows 与 macOS）。启动客户端后，务必勾选「启用全局快捷键」选项。回到 HBuilderX，选中待处理的代码，按下 Ctrl+Alt+G（Windows）或 Cmd+Option+G（macOS）——选中内容将自动发送至 CodeGeex，并由其生成补全建议。

配置 HBuilderX 以适配外部 AI 工具协作

若已采用上述替代方案，以下配置可减少摩擦。

第一步：关闭自动保存干扰
进入「工具」→「设置」→「文件」，取消勾选「保存时自动格式化」与「保存时自动修复」。此举可防止 AI 生成的代码被格式化插件擅自修改缩进或语法，避免冲突。

第二步：设置剪贴板权限（Windows 必做）
右键 HBuilderX 快捷方式，选择「属性」，切换到「兼容性」选项卡，勾选「以管理员身份运行此程序」，点击确定。否则 CodeGeex 客户端可能无法正常读取 HBuilderX 剪贴板内容。

第三步：配置代码片段触发词
进入「工具」→「代码块」，新建代码块，名称填写“ai-req”，内容填写：

将光标定位符 $0 设为插入点。之后在编辑器中键入“ai-req”并按 Tab 键，即可快速插入该注释标记，便于后续批量提取提示词。