HBuilderX 引入 CodeGeex 插件的完整配置步骤

在HBuilderX中启用CodeGeex需完成四步：安装插件（工具→插件安装→搜CodeGeex→重启）、配置API密钥（设置中搜索codegeex.apiKey并粘贴）、限定语言范围（编辑codegeex.languageWhitelist为数组）、设置补全触发模式（启用codegeex.autoTrigger或用Ctrl+Enter手动触发）。

在 HBuilderX 中启用 CodeGeex AI 编程辅助功能，需完成插件安装、API 密钥配置、语言范围限定及补全触发模式设置四步操作，缺一不可，否则无法调用远程模型生成代码或补全建议。

安装 CodeGeex 插件

打开 HBuilderX → 顶部菜单栏点击【工具】→ 选择【插件安装】→ 在弹出窗口的搜索框中输入 【CodeGeex】 → 确认发布者为 Zhipu AI → 点击“安装”按钮。

安装完成后必须重启 HBuilderX，否则插件不加载、菜单栏不会出现 CodeGeex 入口。

获取并填入 API 密钥

方法一：访问智谱AI开放平台正式 https://open.bigmodel.cn → 登录账号 → 进入【API 密钥管理】→ 点击【创建新密钥】→ 复制生成的密钥字符串。

方法二：若已登录 codegeex.cn，可在个人中心 → API 设置中直接查看密钥（注意密钥仅显示一次，刷新后不可见）。

回到 HBuilderX → 按 Ctrl+, 打开设置 → 左侧切换到【用户设置】→ 搜索框输入 【codegeex.apiKey】 → 在右侧输入框粘贴密钥 → 保存设置。

⚠️ 密钥错误或为空会导致所有 CodeGeex 功能灰显不可用，且控制台无明确报错提示，只静默失败。

限定支持的语言与启用自动补全

第一步：在设置中搜索 【codegeex.languageWhitelist】 → 点击右侧“编辑设置(JSON)” → 替换默认值为数组格式，例如：["javascript", "vue", "html", "typescript"] → 保存。

第二步：搜索 【codegeex.autoTrigger】 → 勾选启用自动补全 → 此时在 .js 或 .vue 文件中输入函数名后接空格或分号，将自动弹出建议。

第三步：若不希望全局生效，可取消勾选 autoTrigger，改用快捷键 Ctrl+Enter 手动唤起补全面板——这对写注释或临时调试更精准，避免干扰变量命名过程。