思源笔记常见问题解答：新手入门必看

你是否在使用思源笔记时遇到过数据同步失败、找不到块标、密钥丢失等问题？本文汇总了新手入门最常遇到的 8 类问题，通过图文结合的方式提供详细解决方案，帮助你快速掌握这款隐私优先的个人知识管理工具。读完本文后，你将能够独立解决 90% 的日常使用问题，让笔记管理更高效。

数据存储与管理

数据存储路径与结构

思源笔记采用本地优先的存储方式，所有数据保存在工作空间的 data 目录下，结构清晰可查：

• 核心目录：
  • assets：插入的图片、附件等资源文件
  • plugins：已安装插件 plugins/
  • storage：查询条件、布局配置等系统数据 storage/
  • 笔记本文件：以 .sy 为后缀的 JSON 格式文档

注意：切勿手动修改 .sy 文件，可能导致数据损坏。建议通过 导出 Data 功能备份数据。

第三方同步工具使用限制

❌ 禁止使用：百度云、Dropbox 等同步盘直接同步工作空间
✅ 推荐方案：

• 会员用户：使用内置云端同步功能 sync/
• 免费用户：通过「设置 > 导出 > 导出 Data」手动备份 导出功能

界面与基础操作

块标显示与操作

部分用户会发现列表项中的段落块没有显示块标，解决方案如下：

1. 将光标定位到目标块
2. 按下 Ctrl+/ 快捷键调出块标菜单
3. 或通过右键菜单选择「显示块标」

技术原理：列表项下第一个子块默认隐藏块标，通过 block/ 模块的快捷键监听实现显示切换。

编辑器快捷键速查

常用效率快捷键：

功能	Windows/Linux	Mac
块引用	Ctrl+Shift+]	Cmd+Shift+]
代码块	Ctrl+Shift+K	Cmd+Shift+K
搜索替换	Ctrl+H	Cmd+H

完整快捷键列表可参考 编辑器模块 源码注释。

数据安全与备份

数据仓库密钥管理

密钥是数据加密的核心，建议按以下步骤操作：

1. 初始化：首次使用时自动生成，保存在 conf/ 配置中
2. 备份：在「设置 > 关于 > 数据仓库密钥」中复制保存
3. 多设备同步：所有设备必须使用相同密钥，否则会导致数据不一致

密钥遗失解决方案

若密钥丢失，可通过以下步骤重置（会丢失云端数据）：

1. 导出 Data 备份 导出功能
2. 「设置 > 关于 > 重置数据仓库」
3. 重新初始化密钥并导入备份

警告：重置后旧云端数据将无法访问，请确保已本地备份。

版本升级与维护

安全升级指南

不同安装方式的升级方法：

• 应用商店版：通过应用商店自动更新
• 安装包版：「设置 > 关于 > 检查更新」升级模块
• Docker 版：执行 docker pull b3log/siyuan && docker restart siyuan

重要：工作空间需放在安装目录外，避免升级时文件被清空 安装说明。

高级功能使用

SQL 查询嵌入

思源支持在笔记中直接执行 SQL 查询块级数据：

SELECT block.content, block.updated 
FROM block 
WHERE block.type = 'h1' 
ORDER BY block.updated DESC 
LIMIT 5

SQL 模块源码

闪卡间隔重复

通过 riff/ 模块实现记忆卡片功能：

1. 创建问答块
2. 在「闪卡」面板设置间隔重复规则
3. 通过「学习」按钮进入记忆模式

常见错误排查

数据文件损坏修复

当出现 .sy 文件损坏时：

1. 关闭思源笔记
2. 复制 data/ 目录备份
3. 执行「工具 > 修复数据仓库」修复工具

启动失败解决方案

若程序无法启动，尝试：

• 删除 conf/ 目录下的异常配置 conf/
• 检查日志文件 logs/error.log 日志模块

资源与学习路径

官方文档与社区

• 入门教程：guide/ 目录下的帮助文档
• API 参考：API_zh_CN.md
• 社区支持：中文讨论区

插件与主题推荐

• 插件市场：bazaar/
• 主题目录：themes/
• 热门插件：「表格增强」「网页剪藏」插件开发指南

总结与后续建议

通过本文解答的常见问题，你已掌握思源笔记的核心使用技巧。建议新手用户：

1. 完成 官方指南 中的基础教程
2. 定期通过「导出 Data」功能备份数据
3. 关注 CHANGELOG.md 获取版本更新信息

如有其他问题，可在社区论坛提问或查阅 源码注释 获取技术细节。让思源笔记成为你知识管理的得力助手！