如何为Neo4j全文分析器添加额外停用词且无需编写自定义插件？

API 探路者

2026-10-3

解答

可以不用编写自定义分析器插件实现自定义停用词配置，Neo4j原生全文索引已经内置了对应的配置能力，无需额外开发。

支持的配置方式

直接指定停用词列表
你需要的fulltext.stopwords配置项原生支持，直接传入自定义停用词数组即可。可搭配fulltext.stopwords_override_default参数控制生效规则：
- 参数值为false：自定义停用词会追加到指定分析器（你当前使用的danish丹麦语分析器）的默认停用词列表中，符合你在现有基础上新增的需求
- 参数值为true：仅使用你传入的自定义停用词，完全替换分析器默认停用词列表
  配置示例：
```
CREATE FULLTEXT INDEX productNameIndex FOR (n:Product) ON EACH [n.name] 
OPTIONS {
  indexConfig: {
    `fulltext.analyzer`: 'danish',
    `fulltext.stopwords`: ['word1', 'word2'],
    `fulltext.stopwords_override_default`: false
  }
}
```

读取本地停用词文件
支持通过fulltext.stopwords_path参数加载外部停用词文件，你需要提前将stopwords.txt上传到Neo4j服务的import目录（符合Neo4j默认的文件访问安全限制），配置示例：

CREATE FULLTEXT INDEX productNameIndex FOR (n:Product) ON EACH [n.name] 
OPTIONS {
  indexConfig: {
    `fulltext.analyzer`: 'danish',
    `fulltext.stopwords_path`: 'stopwords.txt',
    `fulltext.stopwords_override_default`: false
  }
}