先说个核心判断：同步和迁移，虽然都是让Logseq笔记“搬家”，但本质上是两码事。

同步是持续的双向流动，迁移是一次性的单向搬运。搞混这两个动作，后面就容易翻车。

你想让笔记在电脑和手机之间实时更新，不丢内容、不乱格式，还不想依赖厂商服务器，那Git就是目前最稳的方案，尤其适合国内用户。下面直接上步骤。

第一步：去Gitee建个私有仓库

把笔记放在自己眼皮底下。登录Gitee → 右上角“+”→“新建仓库”→ 填名称（比如 logseq-kb）→ 务必勾选“私有” → 初始化选项留空。这一步很简单，但“私有”千万别忘了，否则笔记全公开了。

第二步：电脑端初始化并首次推送

打开终端，进入你的Logseq图谱文件夹（例如 ~/Documents/logseq-graph）。

• 执行：git init && git add . && git commit -m "init"
• 添加远程地址：git remote add origin https://gitee.com/yourname/logseq-kb.git
• 推送：git push -u origin main

第一次推送成功后，后面就都是增量操作了。

第三步：安卓手机端拉取并绑定编辑路径

安装Termux → 运行 pkg install git && git clone https://gitee.com/yourname/logseq-kb.git ~/logseq-sync。

打开Logseq安卓版 → 设置 → “图谱路径”改为 /data/data/io.logseq/files/logseq-sync。
注意：这里不是Termux的home路径，而是Logseq应用有读写权限的内部目录。踩坑点就在这里。

第四步：配置自动同步，防止漏改

电脑端加个定时任务：Mac用launchd，Windows用任务计划程序，Linux用crontab。每5分钟执行一次：cd ~/logseq-graph && git add . && git commit -m "auto-sync-$(date +%s)" && git push。

注意一个关键前提：所有设备必须使用同一Git用户名和邮箱。否则提交记录会分裂成多个作者，后面的合并冲突会让你头大。

从Roam Research迁移到Logseq（一次性操作）

如果你是从Roam Research搬家过来的，有两种方法。

方法一：直接导入JSON文件

在Roam Research中进入Settings → Export Graph → 勾选Include attachments → 下载ZIP包 → 解压后得到 graph.json。

打开Logseq桌面端 → 左侧“+” → “Import Roam JSON” → 选择该JSON文件 → 等待完成。这个最省事，适合大部分普通图谱。

方法二：手动拆解后重建（适合大图谱或含特殊块）

用VS Code打开 graph.json，检查是否有大量 "blockId" 嵌套结构。

如果存在，先用社区脚本 roam-to-logseq-converter 预处理成标准Markdown文件夹。再在Logseq中新建图谱，将转换后的 /pages、/journals 等文件夹整体复制进新图谱根目录。这个方法虽麻烦，但能保住块级结构。

需要留意的是：Roam导出的双向链接格式是 [[page-name#^block-id]]，而Logseq只认 [[page-name]]，块级锚点会丢失。要么手动补全，要么用插件 logseq-block-ref-importer 修复——看你图谱里这类链接的数量了。

把旧Logseq图谱迁到新设备（无网络时适用）

如果你只是想把整个图谱从一台电脑搬到另一台，直接复制文件夹就行。

Logseq图谱本质上就是一个包含 config.edn、pages/、journals/、logseq/ 的普通文件夹。找到原图谱所在路径（Windows通常在 C:UsersXXXAppDataRoamingLogseqgraphsXXX，macOS在 ~/Library/Application Support/Logseq/graphs/XXX）。

全选复制 → 粘贴到新设备相同层级目录 → 启动Logseq → 左侧“打开图谱” → 选中该文件夹。这一步操作很简单，直接把文件夹拖进去就行。

但务必注意：新设备上的Logseq版本一定要 ≥ 旧设备版本。否则 config.edn 文件里的新字段可能被忽略甚至报错，到时候还得折腾降级。

《夸克》非常好用的免费AI浏览器

下载APP查看