如何在自定义Vim配色方案中实现Python类名高亮？

问题背景 #

正在制作一款自定义Vim配色方案（灵感来自Monokai，搭配Gruvbox背景，支持准确256色），目标为Python类名设置独立的高亮颜色。使用macOS arm64版本Vim，函数名高亮（pythonFunctionName）正常工作，但类名高亮完全不显示。

尝试的代码片段：

" Python specific
hi pythonFunction     ctermfg=118 cterm=bold
hi pythonBuiltin      ctermfg=81  cterm=bold
hi pythonSelf         ctermfg=161 cterm=italic

" Function and class name highlighting
autocmd FileType python syntax match pythonFunctionName /\<\h\w*\ze\s*(/
autocmd FileType python hi pythonFunctionName ctermfg=118 cterm=bold

autocmd FileType python syntax match pythonClassName /\<class\s\+\zs\h\w*/
autocmd FileType python hi pythonClassName ctermfg=81 cterm=bold

示例代码中MyExample未被高亮：

class MyExample:
    def do_something(self):
        pass

已尝试清除/重定义pythonStatement及相关组，但无效果。需要解决如何在自定义配色中正确高亮Python类名，是否需要使用contains/contained或关联语法组。

解决方案 #

方法一：复用Vim默认Python语法组（推荐） #

Vim的默认Python语法脚本已经将类名标记为pythonType组，无需自行编写正则匹配，直接对该组设置高亮即可：

" 在Python specific区域添加
hi pythonType ctermfg=81 cterm=bold

这种方式简洁且不会与默认语法规则冲突，是最可靠的方案。

方法二：修复自定义类名匹配规则 #

如果坚持使用自定义的pythonClassName组，需要解决语法组覆盖问题：

1. 确保匹配规则在重新定义pythonStatement之后执行，避免被清除
2. 使用containedin关联到pythonStatement组，确保匹配生效

修改后的代码：

augroup PythonAttributeHighlight
    autocmd!
    " ... 其他配置 ...
    autocmd FileType python syntax clear pythonStatement
    autocmd FileType python syntax keyword pythonStatement def class with as import from global nonlocal lambda yield async await
    " ... 其他pythonStatement相关定义 ...
    " 类名高亮放在pythonStatement重新定义之后
    autocmd FileType python syntax match pythonClassName /\<class\s\+\zs\h\w*/ containedin=pythonStatement
    autocmd FileType python hi pythonClassName ctermfg=81 cterm=bold
augroup END

方法三：定义类区域包含类名 #

通过定义pythonClass语法区域，明确包含类名匹配：

autocmd FileType python syntax region pythonClass start=/\<class\s\+/ end=/:/ contains=pythonClassName
autocmd FileType python syntax match pythonClassName /\h\w*/ contained
autocmd FileType python hi pythonClassName ctermfg=81 cterm=bold

这种方式明确限定了类名的匹配范围，避免被其他语法组干扰。

内容的提问来源于stack exchange，提问作者Stochastic Cactus