SiYuan 工作区迁移:3 步把笔记完整搬上新设备

发布时间:2026/8/31 20:11:37
SiYuan 工作区迁移:3 步把笔记完整搬上新设备 SiYuan 工作区迁移3 步把笔记完整搬上新设备【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan换电脑、重装系统最怕的就是笔记跟着一起丢。SiYuan 的工作区迁移其实不复杂旧设备导出备份、传到新设备、导入后重启十分钟就能完成。这篇教程把 SiYuan 数据备份、路径位置和跨设备同步的注意事项一次讲清楚照着做就行。迁移前先把三件事确认清楚笔记到底存在哪。SiYuan 把笔记、图片和设置都放在工作区的 data 文件夹里默认工作区位置是WindowsC:\Users\用户名\AppData\Roaming\SiYuanmacOS~/Library/Application Support/SiYuanLinux~/.config/SiYuan先看一下 data 文件夹的总大小这直接决定备份文件有多大。备份怎么传。备份导出后是一个 .sybackup 文件确认 U 盘或网盘剩余空间够放它再开始传输。新设备装什么。桌面端直接下载对应系统的安装包手机端在应用商店搜索 SiYuan 安装服务器场景可以用 Docker 镜像 b3log/siyuan 起一个服务浏览器访问即可。按主路径完成迁移第一步在旧设备导出备份文件打开 SiYuan点右上角齿轮进入设置左侧选择「导入和导出」点「导出 Data」等进度条走完备份会生成一个 .sybackup 文件记住保存位置第二步把备份传到新设备用 U 盘或网盘把 .sybackup 文件拷到新设备。注意官方不建议用第三方同步盘直接同步工作区目录那样可能损坏数据手动搬运单个备份文件才是稳妥做法。第三步在新设备导入安装并启动 SiYuan完成初始设置打开 设置 → 导入和导出 → 「导入 Data」选中刚才拷贝过来的 .sybackup 文件等待导入完成手机上的入口不同右侧栏 → 关于 → 导入 Data。第四步重启应用导入完成后重启 SiYuan让全文索引重建完成然后打开任意一篇笔记确认能正常加载。主路径走不通时手动复制 data 目录备份文件大到没法传、或导入反复失败时可以绕过应用在文件管理器里直接复制整个 data 文件夹assets/你插入过的所有图片和资源storage/布局、查询条件、闪卡数据plugins/已安装的插件data 目录就是工作区的全部数据拷到新设备相同的位置再打开即可。先退出旧设备上的 SiYuan 再复制避免文件写一半。这条路只在前述导出导入确实走不通时才需要。迁移后 10 分钟校验检查项怎么看不通过的常见原因笔记内容随机打开 10 篇看正文、格式、大纲导入时选错了备份文件图片显示打开含图笔记确认没有裂图备份文件传输时不完整插件与主题核对插件列表和外观设置只复制了 data 的部分子目录双向链接与块引用打开反向链接面板和图形视图核对索引还没重建完成排错速查症状可能原因处理方式备份文件特别大图片等资源积累多在 设置 → 资源 中清理未引用资源后重新导出导入失败或中途报错备份文件损坏核对两端文件大小重新拷贝导入后插件、主题不见了只导入了部分数据用完整备份重导或手动复制整个 data 目录提示数据仓库密钥不一致密钥没同步到新设备在 设置 → 关于 中复制密钥字符串再导入让迁移只发生一次多工作区并存SiYuan 支持在 设置 → 工作区 管理多个工作区新旧数据可以并存核对无误后再淘汰旧的。配置云同步开通会员后开启云端同步日常改动自动同步跨设备同步就不再依赖手动备份。定期导出 Data养成每周导出一次的习惯并把备份放在工作区之外重装系统都不慌。更多细节见 README.zh-CN.md工作区管理源码在 kernel/api/workspace.go。记住一条原则日常备份走导出 Data兜底走手动复制 data 目录迁移后花 10 分钟对照检查表核对新设备就可以放心用了。【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考