利用一个已经存在的语法文件可以节省很多时间。首先看 $VIMRUNTIME/syntax 目录下是
否存在一种类似语言的语法文件。这些文件同时可以让你了解语法文件的一般布局。为了
进一步理解，你需要阅读以下的部分。
让我们先从简单的命令开始。在定义新的语法之前，我们需要清除旧的定义:
:syntax clear
:syntax
:syntax list {group-name}
:syntax case match
:syntax case ignore
最基本的语法元素是关键字。要定义一个关键字，用以下命令:
:syntax keyword {group} {keyword} ...
{group} 是语法组的名字。用 ":highlight" 命令，你可以对 {group} 设定颜色。
{keyword} 参数是关键字。这里有一些例子:
:syntax keyword xType int long char
:syntax keyword xStatement if then else endif
:highlight link xType Type
:highlight link xStatement Statement
警告信息。
x 语言在关键字中用到了 '-' 字符。使用的方法如下:
:setlocal iskeyword+=-
:syntax keyword xStatement when-not
:syntax keyword xStatement n[ext]
试想一下定义更复杂的东西。你想要匹配普通的标识符。对此，你定义一个匹配语法项
目。它会匹配任意一个只由小写字母组成的单词:
:syntax match xIdentifier /\<\l\+\>/
备注:
关键字超越其它的语法项目。这样上面的 ":syntax keyword" 命令定义的
"if"，"then" 等关键字将被视为关键字，即使它们匹配 xIdentifier 的模式。
最后一部分是一个模式 (类似查找中的模式)。// 用来包含模式 (像 ":substitute" 命
令中的一样)。你也可以用其它的字符，比如加号或者引号。
现在定义一个注释的匹配。在 x 语言中注释是以 # 开头的行:
:syntax match xComment /#.*/
在 x 样例语言中，字符串用双引号 (") 来包含。要高亮一个字符串，你需要定义一个区
域。你需要一个区域的开头 (双引号) 和一个区域的结尾 (双引号)。定义如下所示:
:syntax region xString start=/"/ end=/"/
"A string with a double quote (\") in it"
这会带来一个问题: 字符串中间的双引号会结束区域。你需要告诉 Vim 忽略任何转义之
后的双引号:
:syntax region xString start=/"/ skip=/\\"/ end=/"/
看一下这个注释:
%Get input TODO: Skip white space
你想将 "TODO" 高亮显示成黄色字符，即使它在一个蓝色高亮显示的注释中。要使 Vim
了解到这些，你需要定义以下的语法组:
:syntax keyword xTodo TODO contained
:syntax match xComment /%.*/ contains=xTodo
:syntax region xBlock start=/{/ end=/}/ contains=xBlock
while i < b {
if a {
b = c;
}
}
首先一个 xBlock 开始于第一行的 {。第二行中有另一个 {。因为我们已经在一个
xBlock 之内，因此一个嵌套的 xBlock 在此处开始。这样 "b = c" 那一行在第二级的
xBlock 区域之内。下一行有一个 }，这将和区域的结尾相匹配。它会结束嵌套的
xBlock。因为这个 } 存在于嵌套的区域，它在第一个 xBlock 区域的视野里被隐藏。因
此最后一行的 } 结束第一个 xBlock 区域。
保 留 结 尾
考虑下面的两个语法项目:
:syntax region xComment start=/%/ end=/$/ contained
:syntax region xPreProc start=/#/ end=/$/ contains=xComment
#define X = Y % Comment text
int foo = 1;
你看到的是第二行也被当作预处理高亮显示。预处理命令应该在行结尾处结束。这也是你
要使用 "end=/$/" 的原因。但到底是哪里错了呢？
问题在于被包含的注释。注释以 % 开始，在行尾结束。注释结束后，预处理语法继
续，这是在行尾已被处理之后进行的，因此下一行也被认为是预处理命令。
为避免这个问题，避免一个包含在内的语法项目吃掉一个必需的行尾，使用
"keepend" 参数。这样就会解决两个行结尾的匹配问题:
:syntax region xComment start=/%/ end=/$/ contained
:syntax region xPreProc start=/#/ end=/$/ contains=xComment keepend
:syntax region xList start=/\[/ end=/\]/ contains=ALL
:syntax region xList start=/\[/ end=/\]/ contains=ALLBUT,xString
x 语言有这种形式的语句:
if (condition) then
你想对这三种项目使用不同的高亮。尽管 "(condition)" 和 "then" 可能在其它地方有
其它的高亮显示方式。这时你需要这样做:
:syntax match xIf /if/ nextgroup=xIfCondition skipwhite
:syntax match xIfCondition /([^)]*)/ contained nextgroup=xThen skipwhite
:syntax match xThen /then/ contained
if not (condition) then
"if" 匹配 xIf。"not" 并不匹配指定的跟随组 xIfCondition，这样只有 "if" 被高亮显
示。
"skipwhite" 参数告诉 Vim 空白字符 (空格和制表符) 可以出现在项目之间。相似地，
"skipnl" 参数允许项目之间存在换行符；"skipempty" 允许存在空行。注意 "skipnl"
并不忽略一个空行，换行符之后必须有能够匹配的内容。
MATCHGROUP
当你定义一个区域时，整个区域将根据指定的组名被高亮显示。比如，要高亮显示
xInside 组被小括号 () 包含的部分，用下面的命令:
:syntax region xInside start=/(/ end=/)/
:syntax region xInside matchgroup=xParen start=/(/ end=/)/
"matchgroup" 参数适用于它之后的区域开头或结尾。在前一例中，开头和结尾都以
xParen 方式高亮显示。如果要用 xParenEnd 显示结尾:
:syntax region xInside matchgroup=xParen start=/(/
\ matchgroup=xParenEnd end=/)/
:syntax region cWhile matchgroup=cWhile start=/while\s*(/ end=/)/
\ contains=cCondNest
:syntax region cFor matchgroup=cFor start=/for\s*(/ end=/)/
\ contains=cCondNest
:syntax region cCondNest start=/(/ end=/)/ contained transparent
注意 "matchgroup" 参数和项目本身是同一组。为什么要定义它呢？使用
"matchgroup" 的副作用是被包含的项目并不会在开始项目之中寻找匹配。这样就避免了
cCondNest 组匹配 "for" 或 "while" 后面立即跟随的 (。否则，它会扫描整个文本直到
匹配的 )，而区域从其后继续。现在 cConNest 只在开始模式匹配后才开始匹配，就是在
第一个 ( 之后。
位 移
假设你要定义一个在 "if" 之后并在 ( 和 ) 之间的区域。但是你不想包括 "if" 或者 (
和 )。你可以为模式定义一个位移。比如:
:syntax region xCond start=/if\s*(/ms=e+1 end=/)/me=s-1
if (foo == bar)
只有 "foo == bar" 部分以 xCond 方式高亮显示。
关于偏移量的更多信息，参考: :syn-pattern-offset 。
ONELINE
"oneline" 参数说明区域不超过一行的范围。比如:
:syntax region xIfThen start=/if/ end=/then/ oneline
备注:
当使用 "oneline" 时，如果结尾模式没有在同一行被匹配，那么整个区域就不
会匹配。如果不指定 "oneline"，Vim 不会 检查结尾模式是否匹配；即使结
尾模式在文件后面的部分没有匹配，区域也将开始匹配。
续 行 及 避 免
现在事情变得有点复杂。让我们来定义一个预处理行。它以 # 开始到行尾结束。一个以
\ 结束的行使得下一行成为它的续行。这样你可以允许语法项目包括一个续行模式:
:syntax region xPreProc start=/^#/ end=/$/ contains=xLineContinue
:syntax match xLineContinue "\\$" contained
#define SPAM spam spam spam \
bacon and spam
在本例中，这就是你所需要的。如果它并不是你想要的，你可以通过给被包含的模式添加
"excludenl" 参数来使区域在一个单行上。比如，你想高亮显示 xPreProc 中只在行结尾
处的 "end"。为了避免 xPreProc 像 xLineContinue 那样扩展到下一行，使用
"excludenl":
:syntax region xPreProc start=/^#/ end=/$/
\ contains=xLineContinue,xPreProcEnd
:syntax match xPreProcEnd excludenl /end$/ contained
:syntax match xLineContinue "\\$" contained
开始编写语法文件时，你会注意到你要产生很多的语法组。Vim 能让你定义一个语法的集
合 -- 簇 (cluster)。
假设你有一个语言，它含有 "for" 循环，"if" 语句，"while" 循环和函数。它们都
含有相同的语法元素: 数字，标识符。你可以这样定义它们:
:syntax match xFor /^for.*/ contains=xNumber,xIdent
:syntax match xIf /^if.*/ contains=xNumber,xIdent
:syntax match xWhile /^while.*/ contains=xNumber,xIdent
:syntax cluster xState contains=xNumber,xIdent
:syntax match xFor /^for.*/ contains=@xState
:syntax match xIf /^if.*/ contains=@xState
:syntax match xWhile /^while.*/ contains=@xState
:syntax cluster xState add=xString
44.9 包含其它语法文件
C++ 语言的语法是 C 语言的超集。因为你不想编写两个独立的语法文件，你可以在 C++
语法文件中首先读入 C 语言的语法文件:
:runtime! syntax/c.vim
:syntax keyword cppStatement new delete this friend using
:syntax include @Pod <sfile>:p:h/pod.vim
:syntax region perlPOD start=/^=head/ end=/^=cut/ contains=@Pod
<sfine>:p:h/" 部分使用当前文件的名字 (<sfile>)，把它展开成全路径 (:p)，然
后取头部分 (:h)。结果就是文件的目录名。这将包含相同目录下的 pod.vim 文件。
编译器处理起这些来很简单。它们在文件头开始解析以至文件尾。Vim 并没有这么简单。
它必须从编辑进行的中间开始。那么怎么确定它的位置？
秘密在于 ":syntax sync" 命令。它告诉 Vim 怎样找出当前位置。比如，下面的命令
告诉 Vim 向后扫描 C 风格注释的开头和结尾，并对注释高亮显示:
:syntax sync ccomment
:syntax sync ccomment minlines=10 maxlines=500
:syntax sync ccomment xAltComment
:syntax sync minlines=150
:syntax sync match {sync-group-name}
\ grouphere {group-name} {pattern}
{pattern}，名为 {group-name} 的语法组会在其后开始。
{sync-group-name} 用于给这个同步规格说明一个名字。比如，外壳脚本的 if 语句以
"if" 开头，以 "fi" 结尾。
if [ --f file.txt ] ; then
echo "File exists"
fi
你可以用下面的命令为这个语法定义一个 "grouphere" 指示:
:syntax sync match shIfSync grouphere shIf "\<if\>"
:syntax sync match shIfSync groupthere NONE "\<fi\>"
{} 内的所有部分，即使它们通常能在其它的同步方法
中匹配:
:syntax sync match xSpecial /{.*}/
当你新的语法文件要投入使用时，把它放到在 'runtimepath' 下的一个 "syntax" 目
录。对 Unix 来讲，它可以是 "~/.vim/syntax"。
语法文件的名字必须要和文件类型相同并以 ".vim" 做后缀。这样，对 x 语言来讲，
这个文件的完整路径是:
~/.vim/syntax/x.vim
你要确保该文件类型可被识别。参考 43.2 。
如果你的语言文件工作的很好，你也许想要其他的 Vim 用户来使用。首先阅读下一节以
确保你的文件能很好的适用于别人。然后将它 email 给 Vim 维护者:
<maintainer@vim.org>。并要解释文件类型是怎样识别的。如果幸运的话，你的文件会包
括在 Vim 的下一版本中！
向 已 有 文 件 添 加 项 目
我们前边是假定你要写一个全新的语法文件。如果一个已有的语法文件可以工作但是缺少
某些项目，你可以将这些项目添加到另一个独立的文件。这样不用改变发布的语言文件，
因为安装 Vim 的新版本时会丢失这些改变。
在你的文件中写入语法命令 (也许要用到已有语法的组名)。比如，给 C 语法文件添
加新的变量类型:
:syntax keyword cType off_t uint
~/.vim/after/syntax/c.vim
如果所有的 Vim 用户都能交换语法文件岂不更好？为此，语法文件必须符合一些规则。
首先要有一个说明语法文件目的，维护人，以及更新时间的文件头。但不要包含太多的历
史更改信息。比如:
" Vim syntax file
" Language: C
" Maintainer: Bram Moolenaar <Bram@vim.org>
" Last Change: 2001 Jun 18
" Remark: Included by the C++ syntax.
if exists("b:current_syntax")
finish
endif
hi def link nameString String
hi def link nameNumber Number
hi def link nameCommand Statement
... 等等 ...
CTRL-L 的速
度。