更新记录

1.0.4（2025-12-29） 下载此版本

修复Windows11系统导出备份时插件目录为空的bug

1.0.1（2025-12-29） 下载此版本

优化性能

1.0.0（2025-12-29） 下载此版本

HBuilderX 配置备份助手 (mc-config-backup)

一键备份和恢复您的 HBuilderX 开发环境配置，不仅包括设置和快捷键，还能检测并提示恢复后的环境差异（如缺失插件、无效路径），是您迁移开发环境、重装系统的得力助手。

⚠️ 注意：本插件仅用于备份“用户自定义配置”，不会备份 HBuilderX 软件本身。

✨ 主要功能

• **

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

HBuilderX 配置备份助手 (mc-config-backup)

一键备份和恢复您的 HBuilderX 开发环境配置，不仅包括设置和快捷键，还能检测并提示恢复后的环境差异（如缺失插件、无效路径），是您迁移开发环境、重装系统的得力助手。

⚠️ 注意：本插件仅用于备份“用户自定义配置”，不会备份 HBuilderX 软件本身。

✨ 主要功能

• 🚀 一键备份

  • 全量备份：自动打包 settings.json（用户设置）、keybindings.json（快捷键）、external-commands.json（外部命令）以及所有代码块（snippets）。
  • 插件清单：智能记录用户安装的第三方插件（自动过滤 HBuilderX 内置插件），避免恢复时产生干扰。
  • 灵活存储：默认支持备份到桌面，也支持自定义保存到任意文件夹（跨设备迁移更方便）。

• 🛡️ 智能恢复 & 体检

  • 原生体验：使用操作系统原生的文件选择对话框，操作习惯零门槛。
  • 环境体检报告：恢复完成后，自动扫描并生成“恢复体检报告”：
  • 🧩 插件检查：对比备份清单，列出您在新电脑上尚未安装的用户插件。
  • ⚠️ 路径检查：自动通过静态分析检测配置文件中的本地绝对路径（如 SDK 路径、工具路径），如果新电脑上不存在，会高亮示警，防止编译失败。

📖 使用指南

插件安装后，功能入口位于顶部菜单栏的 【工具 (Tools)】 菜单中。

1. 备份配置 (Backup)

1. 点击菜单：工具 -> 备份配置。
2. 选择保存位置：
   • 桌面：直接保存到当前用户的桌面。
   • 自定义路径 (输入)：在弹出的输入框中确认或修改保存路径（默认为文档目录）。
3. 提示“备份成功”后，文件将保存为 hbuilderx_backup_yyyy-MM-ddTHH-mm-ss.json。

2. 恢复配置 (Restore)

1. 点击菜单：工具 -> 恢复配置。
2. 在弹出的文件选择窗口中，找到并选中您的 .json 备份文件。
3. 等待恢复完成。
4. 重要：如果插件检测到环境差异（如缺插件），会自动打开“恢复体检报告”面板。请根据提示在插件市场安装缺失插件。
5. 最后一步：重启 HBuilderX 以使所有设置生效。

ℹ️ 常见问题

Q: 为什么恢复后感觉没有生效？ A: HBuilderX 的核心配置文件在启动时加载。恢复完成后，必须重启 HBuilderX 才能看到效果。

Q: 为什么“体检报告”说我缺少 git 插件？ A: 最新版插件已优化逻辑，会自动过滤 HBuilderX 内置插件（如 git, uni-app 编译核心等），只报告您自己安装的第三方插件。如果您看到此提示，请检查插件是否有更新。

Q: 点击“自定义路径”没有反应？ A: 为了兼容主要操作系统并防止死机，我们使用了文本输入框来确定路径。请确保输入的文件夹路径是存在的。

📂 备份内容清单

Enjoy your coding!