简介Obsidian Dataview 插件资源包主要面向 Obsidian 用户用于扩展笔记软件在数据查询、任务管理和时间规划方面的能力。压缩包内共有四个文件包含两个 JSON 配置文件、一个 JavaScript 核心脚本和一个 CSS 样式表整体大小约四百六十 KB结构紧凑适合不同水平的 Obsidian 使用者参考学习。具体来说插件支持倒计时功能用户可设置目标日期并直观查看剩余天数支持通过查询语言创建动态表格能够对字段进行过滤、排序和计算还能跨笔记检索未完成任务使笔记成为一个实时更新的任务清单。包内的 manifest 文件记录插件元数据主脚本承载核心逻辑样式表控制界面外观示例数据则帮助理解查询输出。目前已有八百五十七人学习下载借助它可快速掌握 Dataview 的核心用法将 Obsidian 打造为集笔记、追踪、分析于一体的个人知识工作台。1. 笔记越堆越乱你只是缺一个“数据库思维”在 Obsidian 里装了 300 篇笔记想找“上个月记录的、还没彻底搞懂的红黑树算法”翻目录翻了十分钟最后放弃了。这不是个例。Obsidian 的文件树和全文搜索能解决“字面检索”解决不了“按状态、按标签、按日期、按优先级筛选”这种结构化查询。dataview 插件就是来填这个坑的它把每篇带 frontmatter 的 Markdown 笔记当成一条数据库记录让你用 SQL 风格的 DQL 查询语言在一个库里实时拉出动态列表、表格、任务清单。一句话dataview 是 Obsidian 生态里最值得先装的“查询引擎”前提是你愿意顺手把笔记顶部的 YAML 字段写规矩。它学起来像 SQL 的迷你版效果却直接决定知识库能不能变成你的第二大脑。适合谁用笔记量过千、靠标签打天下但越来越乱的重度用户想做项目管理台账、错题本、读书笔记索引、周报自动汇总的玩家。如果你只写了二十篇日记用不上但你大概率早晚会用上。2. 在 dataview 之前先学会让你的笔记“自我标记”frontmatter 与元数据模型很多人装了 dataview 后觉得“这插件不行”跑不出东西来根源只有一个笔记里根本没有结构化元数据。dataview 不是全文搜索引擎它查的是“元数据”。什么叫元数据就是笔记的属性作者、创建时间、截止日期、状态、标签、优先级。你可以在正文里写“截止到 2025-04-20”dataview 不理会必须把日期写进 YAML 头它才认。2.1 为什么普通搜索不够从全文检索到结构化查询Obsidian 原生搜索按字面匹配你搜“前端路线”它只返回包含这四个字的文件。dataview 查的是“field”比如where status doing它能列出所有状态为“doing”的笔记哪怕正文里根本没出现“doing”这个词。这种能力恰好适配三类高频场景项目管理台账按状态和截止日期筛选任务、错题本按学科和错误次数调出复习列表、读书笔记按阅读状态和评分聚合待复盘书单。本质上是把笔记的“标签思维”升级成“字段思维”。2.2 YAML frontmatter给每一篇笔记盖一张“名片”在每篇笔记开头用三横线包住一段 YAML--- title: 递归与分治 subject: 算法 status: reviewing difficulty: 8 tags: [数据结构, 重点] created: 2025-03-10 last_reviewed: 2025-04-01 ---status用什么枚举值、difficulty用数字还是文字这些是你的自由但一旦定了就不要改。dataview 的所有威力都构建在字段名的一致上。写法有点讲究日期必须带引号或是标准 ISO 格式2025-04-20不能写2025年4月20日列表字段用[a, b]或- a的写法都可以但混用容易翻车实际上 frontmatter 还支持布尔值、数字、日期、列表和嵌套对象常用到的就这五种。字段类型直接影响查询写法先看下面这张表类型YAML 写法查询示例文本title: 递归WHERE contains(title, 递归)数字difficulty: 8WHERE difficulty 7日期last_reviewed: 2025-04-01WHERE last_reviewed date(now)布尔done: trueWHERE done列表tags: [算法, 重点]WHERE contains(tags, 重点)注意date(now)是 dataview 内置函数每次刷新查询时动态取当前时间这是做“截止日期提醒”的基石。2.3 隐式元数据与文件来源inlinks、outlinks、file.* 字段除了自己写的 frontmatterdataview 也自动为每个文件生成一批隐式字段最常用的是file.lists、file.tasks、file.inlinks、file.outlinks、file.path、file.name、file.cday和file.mtime。这意味着你不需要给每篇笔记写标签它的文件名、路径、链接关系就是元数据。例如想列出所有“没有被任何笔记引用”的孤立笔记LIST FROM 10-笔记 WHERE length(file.inlinks) 0这段查询的意思是从10-笔记这个文件夹里找出没有任何入链的文件。file.inlinks是所有指向当前文件的双链length()是对数组取长度。这类查询对维护知识库健康很有用能让你发现哪些笔记写了就再也没人访问。2.4 把“错题本”目录建起来最小可复用的笔记模板这里上一套可以直接复用的模板以“错题本”为例。新建一个错题本/题目_二分查找.md--- title: 二分查找边界条件 subject: 算法 mistake: 左右边界开闭搞混 wrong_count: 2 status: reviewing due: 2025-04-12 created: 2025-04-01 --- # 题目描述 ... # 正确解法 ... # 错因分析 ...如果这个动作放到每条笔记上做一次虽然烦但一旦形成肌肉记忆后面所有数据操作都是白嫖的。这就是 dataview 的真正哲学你把整理笔记当任务它把这些整理变成可编程的资产。字段不一定要多够用就行后面还要靠它们做筛选和计算。3. 用 DQL 写出第一个查询LIST / TABLE / TASK 三大核心当你有了带 frontmatter 的笔记之后就可以开始写查询了。dataview 支持两种写法行内代码块dataview和行内查询 $ 。多数人日常用块状查询因为它可以在一个页面里排多个结果视图。DQL 的基本结构是LIST 字段输出 FROM 来源 WHERE 筛选条件 SORT 排序字段 方向来源写法有讲究#标签表示标签订阅文件夹表示文件夹来源[[笔记]]表示链接来源三者可以配合。新手最容易踩坑的是把FROM写成FROM 文件夹时文件夹路径里带空格所以路径强制用双引号包起来。想用10-笔记这种文件夹路径时注意必须用英文引号。3.1 最小查询命令直接命中文件来源先来一个能跑通的最小命令。下面这段会列出读书笔记文件夹下的所有笔记LIST title FROM 读书笔记如果这只能返回一个列表那还不够实用。改成带条件筛选LIST title FROM 读书笔记 WHERE status want_to_read SORT created ASC3.2 WHERE 的条件逻辑多条件筛选怎么不翻车写 WHERE 是查漏补缺的重头戏。WHERE 后面跟的是一个布尔表达式多个条件用AND、OR连接。LIST title WHERE status reviewing AND difficulty 6这里有个容易踩的坑字段取不到时WHERE status reviewing会自动过滤掉没有status字段的笔记这是 dataview 的静默行为。想要保留没有字段的笔记就要显式写WHERE status reviewing OR !status。这种细节在数据不全时会让你少骂几句。3.3 TABLE 变成表格视图把“项目管理台账”拉出来LIST 只能展示单列最多加个链接行表格才是真正干活的。TA BLE 语法把字段按列展开TABLE 状态, 截止日期, 负责人 FROM 项目台账 WHERE 状态 ! 完成 SORT 截止日期 ASC这里的中文列名完全可以用只要你的 frontmatter 里写了对应的字段名。如果字段是英文、想在表格里显示中文表头用TABLE AS语法TABLE status AS 状态, due AS 截止日期, owner AS 负责人 FROM 项目台账 WHERE status ! done SORT due ASC这是实际做项目台账时最常用到的形式每天打开一个 “看板.md”立刻得到一张“所有未完成任务按截止日期从早到晚排列”的实时表格再加一行TASK查任务整个项目进度一目了然完全不用手工维护第二份表格。这也是 Obsidian 里基于 dataview 搭项目管理台账的常见做法稳定、好复制。3.4 TASK 查询把没打过勾的下一行行动找出来obsidian 原生的任务列表是- [ ]这种 checkboxdataview 除了能按笔记查也能直接查任务行。下面的查询列出所有标了#待办且未完成的任务TASK WHERE !completed AND contains(tags, 待办)TASK查询和LIST/TABLE不同它直接遍历库里的所有 checkbox 行输出是个任务列表勾掉其中一个dataview 刷新后自动消失。适合用来收集分散在各种笔记里的行动项比如每周一把#待办拉到一个页面里按星期推进。3.5 将表格配合卡片视图使用dataview 的下游需求有人嫌 TABLE 视图太朴素想要卡片。dataview 本身不产卡片常见做法是配一个名为dataview-cards的 CSS snippet把TABLE的单元格变成卡片网格。这种用法多见于做个人图书馆、错题本截图但本质没变——数据层还是靠 DQL 拉出来的。先跑通表格再去折腾视觉别搞反了。4. 深入 dataview 函数日期、分组与分组后的统计初阶查询能让你少翻目录但真正让 dataview 脱颖而出的是它自带的函数库。日期函数尤其关键因为很多人做知识库是为了“按时复习”“按时跟进”。不掌握date()、dateformat()、dur()这几个你的查询就只能在元数据里打转。4.1 日期函数deadline 前 7 天提醒怎么做dataview 的日期判断基于时间戳。常见做法是给每篇笔记计算“距今多少天”TABLE file.cday, due, dateformat(due, yyyy-MM-dd) AS 截止日 FROM 任务 WHERE due SORT due ASC如果想做“未来七天内到期”的清单TASK WHERE due AND due date(today) dur(7 days) AND !completeddate(today)是当天零点dur(7 days)是七天时长对象两者相加得到一个截止时间所有due在这个时间点之前且未完成的任务都会出现在清单里。这个写法能直接用在学习计划、续费提醒、简历投递跟进里。另一个真实场景是LIST WHERE date(today) dur(3 days) date(last_reviewed) AND status reviewing它要做的事是“把三天内复习过的且状态为复习中的笔记找出来”。这里的date(last_reviewed)会把字符串字段转成日期对象转换失败会返回空值但这个空值照样被 where 过滤所以比较安全。4.2 GROUP BY 与 length()统计一份周报GROUP BY 在 dataview 里算是相对进阶的用法但它能让你把表格变成“分类汇总”视图。假设你的项目台账里每篇笔记都有status字段现在想数一下每个状态各有多少条TABLE length(rows) AS 数量 FROM 项目台账 GROUP BY statusGROUP BY status会把结果按状态值分组length(rows)统计每组里查了多少条记录输出是一个两列表格状态、数量。这种写法做周报非常省事能把“各学科错题分布”“各项目阶段占比”等数据一口气拉出来不用手动数。分组加排序稍微绕一些需要把sort写在 group 后面TABLE length(rows) AS 数量 FROM 项目台账 GROUP BY status SORT length(rows) DESC4.3 内联查询在笔记正文里嵌入动态内容如果你不想在页面底部放一个大查询块而想在正文的一句话里插入计算结果用内联查询$。它的特点是输出一段值而非表格适合做“本页面的读书状态”这种提示。这篇笔记最近复习于$ file.mtime内联查询还有个用途是做汇总卡片本周新增任务$ length(filter(link(date(today).toISOString().split(T)[0]), (t) t))不过内联查询的复杂度和维护成本都不低新手最好先只用来展示单一值或单行结果别把它当表格容器。想在正文里直接显示整段查询结果还是要用dataview块。提到多页面的数据整合需要特别说清一点dataview 做不了跨库查询它一次只查一个 vault。库内文件数量巨大的时候性能更要注意这部分放下一章展开。5. 避坑 / 常见问题dataview 索引延迟、语法陷阱与性能边界dataview 用久了你一定会碰到几个“这插件是不是坏了”的时刻。大多数不是 bug是用法和机制导致的必然现象。这里写五条高频踩坑记录每条都是真实线上运行会遇到的。5.1 现象刚写完的笔记怎么都查不到写完一篇新笔记切换预览模式发现 dataview 表格里没有它刷新也没用。原因dataview 有缓存索引它不会实时扫描每个文件默认按一段时间批量更新元数据。解决执行命令面板里的 “Dataview: Rebuild Index” 强制重建立索引如果只是偶尔遇到等一两分钟再刷新即可。注意 obsidian 本身有延迟打开的设置dataview 可能连索引都还没建立这时候去查文件查询结果必然为空纯属正常现象。5.2 现象同一个字段名一部分笔记能查到另一部分查不到打开几个文件frontmatter 看起来都写了status但查询结果有一半没有。原因其中一部分文件的status写在了正文里而不是 frontmatter 里。dataview 默认只把 YAML 头里的字段当成正式元数据正文里的字段需要通过meta()或嵌入方式才可能被识别实际使用中极难处理。解决统一按第 2 章的 frontmatter 规范写用“知识点模板”生成器来统一格式不要靠手敲。另一个隐蔽点frontmatter 里字段缩进不对会被 YAML 解析器当字符串而不是键值这种问题肉眼难发现可以用 obsidian 的“Dataview: View Current File Metadata”命令检查当前文件字段是否被正确解析。5.3 现象WHERE 后面跟了函数查询就变慢甚至报错很多人写WHERE date(today) - due dur(2 days)觉得这是高级写法实际会显著拖慢查询速度。原因dataview 会对每一行计算一次date(today)并且date(today)频繁调用还是相对昂贵。解决先用LET定义变量比如LIST WHERE date(due) date(today) dur(7 days) SORT due这个写法把“今天加七天”算一次比逐行判断快不少。还有一个常见陷阱date(today)和date(now)差异巨大date(today)是当天零点date(now)是当前时间戳用于“七天内到期”的业务判断时date(now)会导致过了当天零点后二十三点到期任务被漏掉必须重视这个时区问题。5.4 现象库大了打开仓库就卡这是性能边界问题。dataview 的索引会把所有文件读进内存当库里有 1 万篇以上文件每次刷新都可能卡。另一个更常见的场景是某一个查询里写了多个FLATTEN或GROUP BY导致结果集膨胀。解决三个思路一是把大查询拆成几个小的减少单次计算量二是把查询范围从整个库收窄到具体文件夹比如FROM 项目台账而不是FROM 三是考虑查 Datacore 这类新一代索引工具后面会细说。注意性能问题在 5 千篇以内的库一般不显著别过早优化。5.5 现象内联查询只显示一行循环结构写不出来$内联查询只支持表达式不支持多行循环语句而且括号嵌套多了容易引号冲突。这是设计决定的不是 bug。解决把复杂的列表结果放到代码块查询里内联查询只用来展示单个数值。如果一定要在正文里插入一个结果列表用dataviewjs写 javascript 块但那是进高阶玩法了建议先把 DQL 跑稳。6. 更进一步把你的 dataview 仪表盘做成“真实看板”的 3 个习惯dataview 的终点不是会写一堆查询而是把它变成一个可维护的信息架构。这里给三个我从实践中沉淀下来的习惯。第一个习惯按业务对象组织笔记而不是按时间。建笔记之前先问自己这是一条“常青笔记”还是“行动笔记”项目台账、错题本、书单这种是常青笔记值得长期维护应该给它们建固定文件夹和固定 frontmatter 字段临时想法、日志则不需要。dataview 查询是建在“稳定实体”上的不是建在“流水笔记”上的。如果你把每篇临时日记都打满标签再写一堆字段查询迟早会变成维护负担。第二个习惯设置一个“配置页”来统一管理筛选参数。例如单独建立_meta/查询参数.mdTABLE this.status, this.阈值 WHERE file.path this.file.path在配置页里用 frontmatter 写下阈值: 5、提醒天数: 7然后在查询中用meta()读取这样以后再调筛选条件不用翻遍所有笔记改一个配置页就能解决。这条在生产环境里特别有用相当于把“代码里的硬编码常量”提炼成了配置文件。第三个习惯是学会看官方的文档和 query 语法速查表。dataview 的正式文档里包含了全部函数和运算符比任何教程都权威。每当我遇到“为什么这个函数不生效”第一反应是查文档里对应该函数的 return type而不是去社区论坛盲搜。返回类型不匹配是最大的隐性坑字面量返回 text而函数返回日期对象二者比较时经常不匹配。我自己的笔记库现在有三套 dataview 看板一个盯项目台账一个盯学生错题本一个盯个人每周复盘。每次打开 Obsidian第一眼看到的就是这些实时数据而不是一排排死的列表。这个习惯帮我把“翻半天找一条旧笔记”的时间降到了零。话说回来刚开始接触 dataview 时我连续写坏了好几次查询后来发现所有坏查询都有一个通病——字段名不统一。先整理字段再谈函数这是我最想提醒新手的一件事。希望这些经验帮到你祝你早日把 Obsidian 变成自己的“第二大脑”。本文还有配套的精品资源点击获取