在_HBuilderX_中应用_CodeGeex_进行_Uni-app_开发的安装配置

CodeGeex 当前不提供 HBuilderX 插件，也不兼容其插件体系；官方仅支持 VS Code 和 JetBrains IDE，HBuilderX 插件市场无相关条目，强行导入 vsix 会导致崩溃。

要在 HBuilderX 中用 CodeGeex 辅助编写 Uni-app 代码，必须先确认 CodeGeex 插件是否适配当前 HBuilderX 版本——截至 2026 年 6 月，CodeGeex 官方未发布 HBuilderX 原生插件，其支持仅限 VS Code 和 JetBrains 系列 IDE；HBuilderX 的插件市场中无 CodeGeex 相关条目，强行导入 .vsix 或 npm 包会导致启动失败或编辑器崩溃。

验证 CodeGeex 是否支持 HBuilderX

打开 HBuilderX → 点击「工具」→「插件市场」→ 在搜索框输入“CodeGeex” → 按回车键。

结果为空列表，且无任何匹配项。这说明【CodeGeex 当前不提供 HBuilderX 插件，也不兼容其插件体系】。

HBuilderX 使用自研插件架构（基于 HTML+JS+Node.js 沙箱），与 VS Code 的 .vsix 扩展机制完全不兼容。直接拖入 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.cn 获取最新接入方式。

方法二：快捷键唤起本地 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 触发注释标记，便于后期批量提取提示词。