用户配置 config.edn:个性化的起点
配置文件位置
Logseq DB 版本的配置文件在:
- Windows:
%APPDATA%\Logseq\config.edn - macOS:
~/Library/Application Support/Logseq/config.edn - Linux:
~/.config/logseq/config.edn
Logseq OG 版本的配置文件在:
- 每个图谱目录下的
logseq/config.edn
OG 版本每个图谱有独立的配置;DB 版本的配置是全局的。
怎么编辑
最简单的方式:不用直接碰文件,在 Logseq 里打开 Settings → 找到你要改的选项,UI 里改就行。大部分常用配置都有对应的 UI 开关。
但有些高级参数只能通过 config.edn 修改。在 Logseq 里输入 Cmd/Ctrl+Shift+E 可以直接打开 config.edn 所在目录(需要 git 插件或系统命令)。
常用配置项速查
;; 快捷键自定义
:custom-shortcuts {
:editor/move-block-up "alt+up"
:editor/move-block-down "alt+down"
}
;; 默认编辑器(打开外部文件时用)
:external-editor "code"
;; 日期格式
:journal/file-name-format "yyyy-MM-dd"
:journal/filename-as-daily-note? false
;; 搜索行为
:feature/enable-search-remove-accents true ;; 搜索时忽略重音
:feature/enable-search-ignore-case true ;; 忽略大小写
;; 代码高亮
:code-highlighting :monokai ;; 可选 monokai / github / dracula
;; 日志级别
:dev/enable-log? false
配置项的层级
config.edn 是 EDN 格式(Clojure 的数据表示法,和 JSON 类似但用方括号)。有两种方式设置配置:
- 全局默认 — 在 config.edn 根层级,所有图谱通用
- 图谱级覆盖 — 在图谱目录里的 config.edn 里可以覆盖某些全局值(OG 版本才有)
安全修改建议
- 修改前备份一份 config.edn(复制改名成 config.edn.bak)
- 用 VS Code 等支持 EDN 语法高亮的编辑器打开,减少语法错误
- 改完保存后重启 Logseq 生效
- 如果 Logseq 启动不了,说明 EDN 格式错了——删除 config.edn,Logseq 会重建默认配置
可配置但 UI 里没有的参数
:logseq.query/nlp-date— 关闭查询里的自然语言日期解析(如果查询里的日期范围判断不准可以关掉):feature/enable-syntax-highlighting?— 完全关闭代码高亮(大图谱可以省内存):preferred-format— 指定新块默认用 Markdown 还是 Org Mode:whiteboard/enable-shadow?— 白板元素是否有阴影效果(关掉更简洁):pdf/default-zoom— PDF 阅读器默认缩放比例
这些参数在开发者文档里有完整列表。大部分用户其实只需要 UI 里的选项——config.edn 主要给高级用户和插件开发者用。