---
title: "Obsidian Search、属性查询与 Graph 分组官方资料摘录"
author: "Perrin Yong"
author_profile: https://www.pystone.net/profile/
published_by: "Perrin Yong"
canonical: https://www.pystone.net/notes/obsidian-search-properties-graph-groups-reference/
type: note
content_role: unspecified
visibility: public
id_stability: rename-stable
source_path: "99-资料来源、摘录与归档/01-外部文章与转载摘录/Obsidian Search、属性查询与 Graph 分组官方资料摘录.md"
content_hash: a81e54f638e0274b9235d0ee24137d06b952f1b04684ea3e352e19ca9aa374d8
knowledge_version: 224c990773de.5fa8af6e39fa
site_commit: 224c990773de166d23a886306577dd90379529ce
notes_commit: 5fa8af6e39fa3891d1b9b4832bfa6c4e0ecaaf0a
---
# Obsidian Search、属性查询与 Graph 分组官方资料摘录

> **source · 来源摘录**
> 本文摘录 Obsidian 官方 Search 与 Graph view 文档，用于说明属性查询、路径排除和 Graph 分组之间的真实语法关系。它支撑的是检索机制，不证明某个目录天然具有正确语义。

## 来源

- Obsidian Help：[*Search*](https://obsidian.md/help/Plugins/Search)
- Obsidian Help：[*Graph view*](https://obsidian.md/help/Plugins/Graph%2Bview)
- 核对日期：2026-07-23

## Search 如何组合条件

Obsidian Search 默认要求空格分隔的多个检索词同时成立；`OR` 表示任选其一，圆括号可以控制组合优先级。若要排除某个词或表达式，在其前面加连字符 `-`。因此，正向条件与排除条件可以出现在同一条查询中。

`path:` 用来匹配文件路径，包含空格或需要精确表达时可以使用双引号。属性检索使用方括号：`[property]` 查找拥有该属性的文件，`[property:value]` 进一步限定属性值。属性名和值也能使用分组、`OR`、精确短语和正则等子查询。

例如：

```text
[layer:evolution] -path:"00-总览与索引/模板"
```

它的机械含义是：保留 `layer` 属性值为 `evolution` 的文件，同时排除路径中命中指定模板目录的文件。Search 只执行查询规则，不会自行理解“综合笔记实例”和“待复制模板”的角色差异。

## Graph 如何复用 Search 语法

Graph view 的 **Search files** 过滤框接受搜索词，用来控制图中显示哪些笔记；Groups 也以搜索词选择节点，再为所选节点指定颜色。官方 Graph 文档对高级语法直接指向 Search 文档，因此属性、路径、否定表达式等组合可以同时用于搜索结果、Graph 过滤和 Graph 分组。

Graph 仍然只是关系的可视化接口：节点表示笔记，连线表示内部链接，节点大小受引用数量影响。颜色分组或节点密度不会自动证明关系有语义、综合已经成熟或知识质量提高。

## 对当前知识库的适用结论

综合模板必须预置 `layer: evolution`，复制后才能生成合格的知识演化层笔记；但模板文件本身不是当前综合认识。模板目录在本工程中稳定承担施工脚手架角色，因此路径排除是当前最小、可审阅的角色边界：保留模板属性，同时不让它进入实际演化节点视图。

这一结论已写入[知识网络构建规则](https://www.pystone.net/notes/knowledge-network-build-rules/)，并在[软件质量为什么是反馈系统而不是测试阶段](https://www.pystone.net/notes/software-quality-as-feedback-system/)中作为“相同表面语法、不同语义角色”的校准案例。若将来模板位置或识别方式改变，路径条件也必须同步复核；不能把当前路径约定误写成 Obsidian 的普遍语义规则。
