HBuilderX手动安装Fitten Code扩展教程

要在 HBuilderX 中集成 Fitten Code，但插件市场无法搜索到该扩展，或者你已获取官方提供的离线安装包——此时最可靠的方式是通过本地安装流程完成部署。简而言之，将 .zip 格式的离线包直接拖入编辑器，让 HBuilderX 自动识别并加载。以下为具体操作步骤，请按顺序执行。

首先确保 HBuilderX 能够正常启动，否则后续所有步骤均无效。双击桌面上的 【HBuilderX.exe】，进入主界面后未出现任何报错弹窗即可。如果启动失败，通常是因为 Windows 缺少 VC++ 运行库或 .NET Framework——请先补全这两项，否则插件系统无法正常运行。打开后观察左下角状态栏，如果显示“就绪”，说明插件环境已初始化完成，可以继续操作。

确认 HBuilderX 已安装并可正常运行

双击桌面快捷方式或解压目录下的 【HBuilderX.exe】 启动编辑器，确保能够进入主界面且无报错弹窗。若启动失败，请先解决 Windows 缺少 VC++ 运行库或 .NET Framework 的问题——这一步骤不完成，后续所有安装操作都会卡在“无法加载插件环境”阶段。

打开后检查左下角状态栏是否显示“就绪”，这是插件系统已初始化的标志。

下载并校验 Fitten Code 离线包

前往 Fitten Code 官方的 GitHub Release 页面，或 DCloud 插件合作渠道，下载与你 HBuilderX 版本匹配的 【.zip 格式插件包】（注意：不是 .vsix，也不是 .jar）。文件名通常类似：fitten-code-hbuilderx-1.4.2.zip，版本号可能有所不同。

下载完成后，右键点击该 zip 文件 → “属性” → 切换到“数字签名”选项卡。如果显示“此文件已由 DCloud 或 Fitten Labs 签名”，说明来源可信；如果没有签名或提示“签名已损坏”，请立即删除并重新下载——【未签名的插件包可能含有恶意脚本，禁止安装】，切勿冒险。

执行本地插件安装

第一步：点击顶部菜单栏 → “工具” → “插件安装”。

第二步：在插件市场窗口右上角，找到并点击 “从本地安装插件” 按钮（图标为文件夹加向上的箭头）。

第三步：在弹出的文件选择对话框中，定位到你刚下载并校验过的 【fitten-code-hbuilderx-*.zip】 文件，选中后点击“打开”。

HBuilderX 会自动解压、校验并注册插件，同时在控制台输出绿色成功日志：“Plugin fitten-code loaded successfully”。此时不要立即关闭窗口，务必等待进度条完全走完——中途关闭会导致插件元数据写入不完整，下次启动时会反复报“插件加载失败”。

启用并登录 Fitten Code

重启 HBuilderX。

重启后，点击顶部菜单栏 → “扩展” → “Fitten Code” → “Open Chat Window”。

首次打开会跳转至内置 WebView 登录页面，输入你在官网注册的账号密码完成绑定。登录成功后，编辑器右下角状态栏会出现 “Fitten: Ready” 提示。

此时你可以选中任意一段 JavaScript 代码，右键 → “Ask Fitten Code to explain”，即可立即获得 AI 解释——这一步验证插件已完全激活。