在Neo4j的Cypher查询语言中，字符串开头匹配是一项基础但非常实用的操作。通过starts with运算符，我们可以快速筛选出节点或关系的某个字符串属性以指定子串开头的记录。这种查询在用户名称检索、编码前缀分类、日志类型过滤等场景中十分常见。与模糊匹配或正则表达式相比，starts with语义清晰，且更容易被查询优化器识别并利用索引加速。
starts with的基本语法
starts with是Cypher中的大小写敏感字符串运算符，它只能用于字符串类型的数据。其标准写法是将其放在WHERE子句中，左边为属性或变量，右边为字面量字符串或字符串表达式。当左侧字符串以右侧内容开始时，返回true，否则返回false。
例如，我们要从Person标签的节点中找出名字以“张”开头的人，可以写成如下语句。这里neo4j会逐行检查name属性，只有前缀相符才纳入结果集。如果name属性本身为null，则starts with的计算结果为null，该节点不会被返回。
MATCH (p:Person) WHERE p.name STARTS WITH '张' RETURN p.name, p.age
从执行角度看，上述语句在未建立索引时会产生全节点扫描。对于数据量较大的库，建议配合索引使用。我们可以在name属性上创建普通范围索引或全文索引，使前缀匹配转为索引查找，从而降低查询耗时。
与正则表达式及字符串函数的对比
很多开发者在需要做开头匹配时，会本能地想到用正则表达式，比如使用=~ '^张.*'。虽然功能上等价，但starts with在可读性和性能上通常更优。正则引擎的解析成本更高，优化器也难以总是将其下推为索引操作。
另一个常见替代是字符串函数left()或substring()，例如WHERE left(p.name, 1) = '张'。这种方式同样可行，但函数包裹属性会导致索引失效，必须全量计算。下面的代码展示了三种写法的差异，实际项目中应优先选择starts with。
// 方法一：starts with，推荐 MATCH (p:Person) WHERE p.name STARTS WITH '张' RETURN p // 方法二：正则，成本高 MATCH (p:Person) WHERE p.name =~ '^张.*' RETURN p // 方法三：函数，索引易失效 MATCH (p:Person) WHERE left(p.name, 1) = '张' RETURN p
大小写敏感与处理策略
starts with严格区分大小写，这意味着'abc' STARTS WITH 'A'会返回false。如果业务要求不区分大小写，就需要先将双方转为统一形式。可以使用toLower()或toUpper()函数处理属性与字面量。
但要注意，对属性使用函数会让普通索引无法生效。此时可考虑在模型中增加一个额外的小写冗余字段，如name_lower，并对其进行索引。查询时直接用starts with匹配该字段，既满足忽略大小写又保留性能优势。
// 不区分大小写但可能不用索引
MATCH (p:Person)
WHERE toLower(p.name) STARTS WITH toLower('zhang')
RETURN p
// 冗余字段方案
MATCH (p:Person)
WHERE p.name_lower STARTS WITH 'zhang'
RETURN p
索引对starts with的优化作用
在Neo4j 4.x及更高版本中，基于btree的范围索引能够支持STARTS WITH前缀查询。当我们执行查询计划时，若看到NodeIndexSeek而非NodeByLabelScan，说明索引已生效。创建索引的语句如下。
对于中文或较长文本，也可评估全文索引，但全文索引默认按分词匹配，对严格前缀支持不如btree直接。因此大多数前缀场景使用普通索引即可。下表简要对比两者特性。
| 索引类型 | 前缀支持 | 大小写 | 典型用途 |
|---|---|---|---|
| btree索引 | 原生支持starts with | 敏感 | 编码、名称前缀 |
| fulltext索引 | 依赖分词器 | 可配置 | 文章内容检索 |
CREATE INDEX person_name_idx FOR (p:Person) ON (p.name)
常见误区与注意事项
一个容易被忽略的点是：当右侧前缀为空字符串时，如p.name STARTS WITH ''，该条件对一切非空字符串均成立，相当于没有过滤。此外，如果属性不是字符串类型，比如是整数，直接使用starts with会报类型错误，需要先用toString()转换。
在关系型数据迁移到图库的过程中，有人误以为starts with能像SQL的LIKE 'abc%'那样自动忽略尾部空格，实际上Neo4j保留字符串原样，空格也是字符的一部分。因此在写入数据前做好清洗，才能保证前缀匹配结果符合预期。
// 数字转字符串后匹配 MATCH (n:Order) WHERE toString(n.code) STARTS WITH '2024' RETURN n
综合来看，starts with是Neo4j处理字符串开头匹配最直接、高效的工具。只要注意大小写、类型以及索引的配合，就能在图查询中稳定发挥其作用。
Neo4jstarts_with字符串匹配修改时间：2026-08-11 15:45:31