简介：Obsidian Dataview 插件详细解析资源，面向使用 Obsidian 进行个人知识管理、需要进阶提升数据查询与任务管理效率的用户。压缩包体积约 460KB，共 4 个文件，包含 1 个核心 JS 脚本、1 个 CSS 样式表与 2 个 JSON 配置文件，分别对应插件核心逻辑、外观样式与配置数据，能够帮助读者快速了解插件的目录结构与各模块用途。资源详细介绍了倒计时语法、表格创建、任务查询等功能的具体用法，例如可通过 dv.date().fromNow() 统计剩余天数，或利用 dv.tasks() 筛选未完成任务，将静态笔记转变为动态管理面板。已有 865 位用户学习下载，适合希望在 Obsidian 中构建个性化知识管理系统、从事项目规划或数据分析的学生与职场人士。通过阅读这份资源，使用者可以更快掌握 Dataview 的常用查询语言与样式调整方法，为后续二次开发或深度使用打下基础。
1. Obsidian dataview笔记查询：把笔记库变成一个可查询的活页夹
写笔记最怕的是记录进去，但再也找不出来。Obsidian 加 dataview 插件以后，等于在笔记库上层铺了一层数据库，不用手工整理分类，只要给笔记打好字段，所有清单、看板、汇总都能实时生成。适合三类人：笔记量超过几百条、需要按状态跟踪项目的知识工作者，以及厌倦了手动维护目录的 Obsidian 重度用户。简单说，这个插件让「写笔记」和「找笔记」之间的成本降到几乎为零。这篇整理的是我从零摸 dataview 时踩过的坑，以及一套能直接落到项目里的写法。
2. 理解 dataview 的工作方式：先有索引，再有查询
很多新手拿到 dataview 就写查询语句，然后发现跑出来结果全不对。玄学问题的根源都在于没有先弄清楚它在索引什么。dataview 不是一个全文搜索引擎，它只认两块东西：笔记的 YAML frontmatter 和笔记正文里的内联字段。所以要让 dataview 干活，第一步不是写语句，而是给你的笔记补充结构化信息。
2.1 frontmatter 字段与内联字段：索引的根基
frontmatter 是每篇笔记开头用三条横线括起来的属性区，dataview 默认会把这里面的键值对当成可查询字段。比如我常用的一套项目笔记模板：
--- tags: [project, active] status: active priority: high due: 2025-05-01 assignee: "@me" ---上面这段不是在写文档，是在给笔记本盖数据库的 schema。status、priority、due、assignee都是可以用 dataview 直接访问的字段。注意due的值是标准的 ISO 日期格式，这很关键，因为 dataview 的日期函数只认yyyy-mm-dd这种格式，写成05/01/2025以后比较日期时一定会出错。
还有一种情况是笔记很多、不想每条都写 YAML，可以写内联字段。比如在正文里写一行deadline:: 2025-05-01，dataview 也能索引到。内联字段适合临时补几个属性，但正式项目我会统一用 frontmatter，因为 YAML 区不参与正文渲染，视觉上干净一点。
如果你看完以上还是觉得晕，记住一句话：先想好你要查什么，再去补字段。没有字段的笔记，dataview 是看不见的。
2.2 四种基本查询类型与他们的边界
DATAVIEW 的基础语句可以理解成四种：TABLE、LIST、TASK、CALENDAR。TABLE 适合当表格看，LIST 适合当清单看，TASK 专门抓复选框任务，CALENDAR 是按日期铺日历视图。我日常 80% 的查询落在 TABLE 和 TASK 上。
TABLE status, due, priority FROM "Project" WHERE status = "active" SORT due ASC这段代码的意思是：从Project文件夹里抓所有笔记，筛选出status等于active的，按due日期升序排列，表格显示status、due、priority三列。FROM指定范围，WHERE做条件过滤，SORT排序，这三个关键词是把笔记变成数据库的关键。
很多人会在这里犯一个错：写WHERE status = active。注意 active 是字符串不是变量，必须打双引号。dataview 的语法对引号敏感，字符串不带引号会被当成一个不存在的字段名，然后查询结果直接为空。LINUX 上文件路径写久了的人最容易踩这个。所以每次写完查询，第一反应不是看结果，而是检查字符串有没有加引号。
3. 实战一：把项目笔记变成可筛选的看板
有了字段和语法基础，就可以做点像样的东西。我建议第一个练手项目就是项目看板，既能摸熟查询语法，又能立刻解决实际问题。
3.1 字段规范与豁免条件：先把底子打牢
做看板前先把字段名统一。我的项目笔记里统一用这几个字段：status（取值 active / on-hold / done）、priority（取值 high / medium / low）、due（日期）、assignee（负责人）、tags（分类标签）。并用一个独立的文件夹Project存放所有项目笔记，避免和日常随手记录混在一起。
这一步就像建数据库前先做表结构设计，字段名不一致，后面写再复杂的查询也没用。另外注意前端显示：显示due列时，如果某篇笔记没写due，会显示空列，排序时它会排在最前面。要解决这个，可以在查询里用default()函数给空值兜底，比如：
TABLE status, default(due, "未排期"), priority FROM "Project" WHERE status != "done" SORT status ASC, due ASCdefault(due, "未排期")的意思是，如果due字段不存在，就在表格里显示「未排期」三个字，这样看板看起来整齐得多。参数也容易理解：第一个参数是你要检查的字段，第二个是不存在时的替代值。这招建议所有看板查询都用上，能过滤掉大量空值噪音。
3.2 动态筛选与分组：看板的进阶形态
基础看板只能看一个文件夹的全量数据，我不想每次手动改WHERE条件，就做了两个自动筛选的小技巧。第一个是用filter函数做状态筛选，第二种是直接在页面顶部写查询，让用户点击属性值快速切换视图，不过 dataview 本身不支持交互式筛选，除非配合外置元标签或 Templater 做动态重写，那种复杂度对一线实践来说有点过头。
我实际用得更顺手的是GROUP BY分组看板：
TABLE rows.file.link, rows.priority, rows.due FROM "Project" WHERE status != "done" GROUP BY status SORT status ASC这段代码根据status字段分组，把已完成和未完成的笔记分成两个区块。rows.file.link是分组后每篇笔记的可点击链接列表，rows.priority会显示所有该组笔记的优先级字段。对于一个十几个项目的文件夹，这张表一眼就能看出哪些任务堆在 waiting on 状态。分组看板的另一个好处是逻辑天然层叠，可以嵌套多个字段做子分组，比如先按assignee分组，再按priority排序，跑项目周报时非常省事。
4. 实战二：利用 TASK 和待办事项实现任务自动清零
看板解决的是「有哪些笔记」的问题，任务管理解决的是「有什么还没做」的问题。dataview 的 TASK 类型会把全库所有带复选框的列表项抓出来，这是一个被很多人忽略但价值很大的功能。
4.1 抓取未完成任务：基础 TASK 查询
我几乎每周都跑一次这个查询，把所有未完成的待办项集中到一张工作台页面来：
TASK FROM "Project" OR "Areas" OR "Inbox" WHERE !completedTASK 语句返回的不是笔记，而是笔记里的每一行勾选项。WHERE !completed表示只显示还没打勾的事项，FROM子句支持多个文件夹，用OR连接。执行完这个查询，等于把散落在各篇笔记里的待办项全部拎出来，显示成一份全局待办清单。
有一点要注意：TASK 查询只抓「含- [ ]的列表项」，不抓普通列表项。如果你想抓带标签的待办，必须写成- [ ] #todo这种形式，然后配合WHERE contains(tags, "todo")过滤。我一般在每个任务项后面打上负责人或模块名，比如- [ ] #todo 前台页面改版 @某开发者，这样导出给同事看时能带上上下文。
4.2 按日期和组织方式拆分任务清单
任务一多，单纯的全量清单也没意义。这时候就轮到date函数出场。典型场景是「未来七天内到期的任务」：
TASK FROM "Project" WHERE !completed AND file.day <= date(today + 7)date(today + 7)会计算当天加七天后的日期，file.day是笔记日期级字段。需要注意的是，today必须是 ISO 格式，它返回的是一个日期对象，和due字段类型一致才能比较。如果你的任务字段叫due，要写WHERE due <= date(today + 7)而不是file.day。
这里比较容易翻车的一个点：date(today + 7)返回的是「今天加 7 天」的日期，但你写date(today+7)不带空格时，某些版本的 dataview 会解析失败。我习惯写成date(today + 7)，加好括号和空格，少给自己挖坑。另一个常见误区是拿字符串和日期比较，比如WHERE due < "2025-05-01"，这种写法在大部分情况下不会报错，但结果往往不对，因为字符串和对象是两种类型，比较结果没法预期。
5. 避坑与常见问题：三个把新手劝退的踩坑点
网上写 dataview 的教程不少，但很少总结为什么会出错。这里记录三个我反复遇到、且本质上都跟语法或类型有关的坑，每条都按现象、原因、解决排列。
5.1 现象：查询结果一直是空白列表
症状是 dataview 页面渲染正常，但数据列表一行都没有。查了半天，确认笔记存在、字段也写了，问题到底在哪？
原因 90% 出在引号上。WHERE status = active少了双引号，dataview 会尝试把active解析成字段，找不到就返回空集。还有一种隐蔽情况是 frontmatter 里字段名大小写不匹配，比如 YAML 写Status，查询写status，dataview 对字段名严格区分大小写。解决方法是统一全部小写字段名，并且查询前先跑一个空查询LIST FROM "Project"验证笔记真的能被抓取，再加 WHERE 条件，逐步排查。
5.2 现象：日期比较结果和预期不符
症状是WHERE due <= date(today)查出来一堆过期任务，但事实上有几篇笔记的 due 明明在未来。
原因往往是日期字段被当成字符串处理。比如在 YAML 里写due: 2025/5/1，dataview 无法识别成日期对象，只能当作普通字符串，字符串比较永远按字典序来，结果当然乱。解决方法是严格用yyyy-mm-dd格式写日期，并在查询里用date(due)显式转换一次，比如WHERE date(due) <= date(today)。转换后 dataview 会先尝试把 due 字段解析成日期，解析失败时那一行会直接被丢弃，你也能更快发现脏数据。
5.3 现象：表格里的文件链接显示成了纯文本
症状是 TABLE 查询结果里，file.link列显示[[note name]]而不是可点击的笔记链接。看起来只是显示问题，但点击不了影响操作效率。
原因是我把file.link写成了普通字符串字段。在 dataview 里，要显示链接必须显式使用file.link作为返回列，或者用link()函数包一层。正确写法是TABLE file.link AS "笔记"，注意这里的AS就是给列取别名。还有一个常见场景：如果你在 YAML 里存了一个笔记名列表，比如related: [[A]], 需要写成TABLE related.file.link才能变成可点击链接，直接用related只会显示为文本。这个坑同事手滑过好几回，现在我的项目模板里固定写好这些列，避免每次重写。
6. 进阶技巧：用 dataview 做自动统计和标签聚合
dataview 不只查列表，还能做轻量统计。我最常用的一招是统计本周新写笔记数和各标签分布，通过length()和filter组合实现。以下是统计某段时间内每篇笔记字数的示例：
TABLE length(file.content) AS "字数", file.mtime FROM "Project" WHERE file.mtime >= date(today - 7) SORT file.mtime ASClength(file.content)可以拿到笔记字数，file.mtime是最后修改时间，WHERE file.mtime >= date(today - 7)筛出最近七天内动过的笔记。这张表对周报和复盘非常有用，能直接看出哪些笔记一直没更新，哪些在活跃变厚。基于同样的思路，你可以把它改成按标签聚合、按文件夹聚合，甚至统计某个标签下的任务数量。
要提醒的是，length(file.content)统计的是纯文本长度，如果把图片附件、内嵌引用都算进去，数值会比实际文字多不少。我一般不会拿它做精确保守，只看相对变化。
用 dataview 做统计的最终目的，是摆脱手工维护「上周写了什么」这类复盘问题。从那以后，我每次写完周报都会习惯性地跑一遍最近七天的笔记统计，看看有没有漏记的待办，再顺手把字段忘写、日期写错的笔记修一下——这套流程走下来，彻底治好了我笔记库吃灰的老毛病。希望帮到你。
本文还有配套的精品资源，点击获取
