需迁移UserData文件夹以完全复现Listary设置：旧电脑退出程序后复制该文件夹，新电脑安装同版本Listary并关闭后覆盖对应路径，重启即可生效全部个性化配置。
如果您在旧电脑上已配置好 Listary 的快捷键、搜索习惯、主题、历史记录等个性化设置，希望在新电脑上完全复现，则需要迁移其配置文件。Listary 的全部用户自定义设置均集中存储于 UserData 文件夹中。以下是具体操作步骤：
一、导出 Listary 配置文件（旧电脑）
Listary 的配置数据全部保存在 UserData 文件夹内，导出即为完整复制该文件夹。此操作可确保历史搜索记录、自定义关键词、界面主题、快捷键映射等全部保留。
1、确认 Listary 当前运行状态：先完全退出 Listary 进程（右键任务栏图标→退出，或通过任务管理器结束 listary.exe）。
2、定位 UserData 文件夹路径：
─ 若为标准安装版（非便携版），路径为：C:\Users\
─ 若为便携版，路径为：与 listary.exe 所在目录同级的 UserData 文件夹。
3、复制整个 UserData 文件夹：选中该文件夹，按 Ctrl+C 复制，粘贴至U盘、网盘或共享文件夹等可转移介质中。
二、导入 Listary 配置文件（新电脑）
导入操作需在新电脑安装相同版本 Listary 后进行，覆盖 UserData 文件夹即可还原全部设置。注意必须保证 Listary 已关闭，否则写入可能失败或被覆盖。
1、在新电脑下载并安装与旧电脑相同主版本号的 Listary（例如均为 Listary 6.x，避免 5.x 与 6.x 混用导致配置不兼容）。
2、安装完成后，先不要启动 Listary，立即按步骤一的方式定位新电脑上的 UserData 文件夹路径（路径结构与旧电脑一致）。
3、将旧电脑导出的 UserData 文件夹整体复制，并覆盖新电脑对应路径下的同名文件夹；覆盖前建议先将新电脑原有的 UserData 文件夹重命名为 UserData_backup 以作保留。
4、完成覆盖后，双击启动 Listary，所有历史记录、关键词、主题、快捷键等设置将立即生效。
三、使用 Listary 内置导出/导入功能（替代方案）
Listary 提供图形化配置导出接口，适用于不熟悉文件路径操作的用户。该方式生成单一 .json 或 .zip 归档，便于跨平台识别，但部分二进制数据（如 DiskSearch.db、Themes 中的 .listarytheme.json）可能未包含在内，完整性略低于直接复制 UserData。
1、在旧电脑运行 Listary，按下快捷键Ctrl + Alt + I打开设置界面。
2、点击左下角“导入/导出” → “导出全部设置”，选择保存位置并确认导出，生成文件如 listary_settings_20260330.zip。
3、在新电脑安装 Listary 后，同样打开设置界面（Ctrl + Alt + I），进入“导入/导出”页，点击“从文件导入设置”，选取前述导出的压缩包。
4、导入完成后重启 Listary，基础设置（偏好、关键词、快捷键）将恢复，但搜索历史（History_v2.sqlite）和磁盘索引库（DiskSearch.db）不会被此方式迁移。
四、验证配置是否完整迁移
迁移完成后需检查关键项目是否生效，避免因路径权限、版本差异或覆盖遗漏导致部分功能异常。验证应聚焦用户可感知的核心设置项。
1、唤出 Listary 搜索框（默认双击 Ctrl 或按 Alt+Q），输入一个曾高频使用的关键词，确认历史匹配项是否出现在首位。
2、右键资源管理器空白处，查看上下文菜单中是否出现 Listary 相关选项（如“在 Listary 中搜索此文件夹”），若缺失，说明注册表集成项未迁移，需重新运行 Listary 安装程序并勾选“集成到右键菜单”。
3、进入 Listary 设置界面（Ctrl + Alt + I），切换至“外观”页签，确认所选主题名称与旧电脑一致；切换至“快捷键”页签，核对自定义热键是否与记忆中完全相同。
