Logseq入门之源文件介绍

水温注意！本文是强行写的。

Logseq作为开源软件，它的文件结构是对用户比较友好的。笔者将在文中简要介绍.logseq和graph(图谱)两个路径下的结构和各文件作用。更细致全面的描述请参考logseq官方的文档及其repo中的注释等。部分内容为笔者自主解释，如有错误敬请指正。

注意：本文内容有可能随着logseq代码更新而部分过时，特别是未来数据库版本开放后。

.logseq

位于C:/users/{username}/.logseq，是logseq的全局软件配置。只有打开graph时会读取一次，更改相关配置时会写入，其他时间都是无读写的。

config.edn 全局配置，即设置-常规-自定义全局配置的文件。
plugins.edn 安装的插件及其元信息。可以使用该文件批量下载插件。操作方法：打开软件后，会提示检测到某些插件未安装于plugins中。使用命令Install plugins from plugins.edn，或者在插件页点击展开后的选项，即可一键下载。

以各graph的路径命名文件夹，里面是.git文件夹

路径下是图谱的transit文件，作用是加快加载时间。

插件的安装路径

插件的设置json文件

部分软件配置，包括当前主题、header上固定的插件等。

即你的图谱（库），存放着你真正的内容。

graph的git库，具体参考git相关资料。logseq的多版本控制功能会创建该目录，建议使用该内置自动commit而不是自行git。

可相对引用的文件，理论上无硬限制。

assets下可以建立多级文件夹，都能引用到。当然相对引用也没那么自由，你在库目录内随便创个文件夹再用相对路径并不可行。

logseq中pdf阅读的截图标注功能会形成png文件自动保存在同一文件夹内。

日志，格式.md，即markdown。

本graph的相关配置和文件。

.recycle 回收站
bak 备份，logseq检测到数据和硬盘上之间存在差异时会写入。当前的作用机制似乎不是很完善，相关代码之后应该还会更新。嗯确信操作无误的话可以删，但没必要。
config.edn 当前库的配置，即设置-常规-自定义配置的文件
custom.css 当前库的主题，即设置-常规-自定义主题的文件
export.css 导出主题，即设置-常规-导出主题的文件。默认并不存在，软件内编辑内容后会自动创建。
graphs-txid.edn logseq官方同步功能所需文件。
metadata.edn 用于存储加密状态，现已弃用。从较新版本开始使用的用户可能不会看到该文件。
pages-metadata.edn 全部页面的元数据，包含名称及创建＆修改时间。0.8.11版本后该文件已弃用，可以直接删。从之后版本开始使用的用户可能不会看到该文件。不过我懒的删了（

除journals外的所有页面，格式同样是.md

logseq的白板。软件内关闭白板功能不会删除该文件夹，请放心关闭。格式.edn。