如何配置Neovim Treesitter为Python文档字符串应用RST高亮？

问题核心 #

直接在Python高亮查询里绑定@rst是无效的——@rst不是Neovim内置的高亮组，而是语法注入标记，需要通过Treesitter的注入机制让RST解析器接管文档字符串的解析，才能应用RST的高亮规则。

正确配置步骤 #

1. 创建语法注入规则文件
   在Neovim配置目录下创建after/queries/python/injections.scm（若文件不存在），添加以下内容：

   (module . (expression_statement (string) @rst))
   

   这条规则会将Python模块下顶级表达式语句中的字符串标记为RST语法注入点，让Treesitter自动调用RST解析器处理该字符串内容。

2. 移除无效的高亮配置
   删除after/queries/python/highlights.scm中那条绑定@rst的规则，无需手动指定高亮组，注入后RST的高亮规则会自动生效。

3. 验证并加载配置

   • 执行:checkhealth nvim-treesitter确认RST解析器的**H（高亮）**特性已启用（你已验证过显示✓，此步为二次确认）
   • 执行:TSUpdate python rst更新解析器，或重启Neovim让配置生效

补充说明 #

之前绑定@comment生效是因为@comment是Neovim内置的高亮组，直接绑定就能应用对应的样式；而@rst是语法注入标识，必须通过注入规则让RST解析器介入，才能实现RST语法的高亮渲染。

内容的提问来源于stack exchange，提问作者M. Burkard