OPTIONS
*options.txt* For Vim version 7.1. 最近更新: 2007年5月
VIM 参考手册 by Bram Moolenaar
译者: Willis
http://vimcdoc.sf.net
选项 *options*
1. 设置选项 |set-option|
2. 自动设置选项 |auto-setting|
3. 选项总结 |option-summary|
选项的总览可见 help.txt |option-list|。
Vim 有很多内部变量和开关，可以达到特殊的效果。这些选项有三种形式:
布尔型 可以打开或关闭 *boolean* *toggle*
数值型 值为数值
字符串 值为字符串
*:se* *:set*
:se[t] 显示所有不同于缺省值的选项。
:se[t] all 显示除了终端设置以外的所有选项。
:se[t] termcap 显示所有的终端选项。注意 在 GUI 里，不会显示键码，因为
它们是内部生成的，无法改变。而且 GUI 里即使修改终端代
码也没用 ...
*E518* *E519*
:se[t] {option}? 显示 {option} 的值。
:se[t] {option} 切换选项: 置位，打开。
数值选项: 显示其值。
字符串选项: 显示其值。
:se[t] no{option} 切换选项: 复位，关闭。
:se[t] {option}! 或
:se[t] inv{option} 切换选项: 反转其值。{Vi 无此功能}{option}& 复位选项为其缺省值。可能和 'compatible' 的现值有关。
{Vi 无此功能}{option}&vi 复位选项为 Vi 的缺省值。{Vi 无此功能}{option}&vim 复位选项为 Vim 的缺省值。{Vi 无此功能}{Vi 无此功能}{option}={value} 或
:se[t] {option}:{value}
设置字符串或数值选项的值为 {value}。
数值选项的值可以用十进制、十六进制 (0x 开头) 或八进制
('0' 开头) (十六进制和八进制的支持只限于提供 strtol()
函数的环境)。
可以用 'wildchar' 输入原来的值 (缺省是 <Tab>，但如果置
位 'compatible'，是 CTRL-E)。见 |cmdline-completion|。
{option} 和 '=' 之间可以有空白，但会被忽略。'=' 和
{value} 之间不能有空白。
|option-backslash| 说明如何在 {value} 里使用空白和反斜
杠。
:se[t] {option}+={value} *:set+=*
把 {value} 加到数值选项里，或者附加到字符串选项之后。
如果选项是逗号分隔的列表，除非原来的值为空，会加上一个
逗号。
如果选项是标志位的列表，删除多余的标志位。如果加入已经
存在的标志位，选项值不变。
另见上面的 |:set-args|。
{Vi 无此功能}{option}^={value} *:set^=*
把 {value} 乘到数值选项里，或者附加到字符串选项之前。
如果选项是逗号分隔的列表，除非原来的值为空，会加上一个
逗号。
另见上面的 |:set-args|。
{Vi 无此功能}{option}-={value} *:set-=*
把 {value} 从数值选项里减去，或者从字符串选项里删除，
如果该值原来存在的话。如果不存在，不会有错误或者警告。
如果选项是逗号分隔的列表，除非新值为空，删除一个逗号。
如果选项是标志位的列表，{value} 必须和选项里出现的顺序
完全相同。一个一个地分别删除标志位可以解决这个问题。
另见上面的 |:set-args|。
{Vi 无此功能}{option} 参数。例如:
:set ai nosi sw=3 ts=3
如果其中一个参数有错，给出错误信息，而且其后的参数也不再处理。
*:set-verbose*
如果 'verbose' 非零，显示选项值的同时会告诉你上次在哪里设置。例如:
:verbose set shiftwidth cindent?
shiftwidth=4
Last set from modeline
cindent
Last set from /usr/local/share/vim/vim60/ftplugin/c.vim
只有请求特定选项的值时才会这么做，":set all" 或者没有参数的 ":set" 都不会。
如果该选项是手动设置的，"Last set" 消息不会给出。对于所有的同名局部选项，只保
存一个位置。因此可以说，该消息针对的是选项名，而不一定是具体某个值。
如果执行函数、用户命名或者自动命令时设定选项，报告的位置是定义它们的脚本。
注意选项的设置也可能是来自设置 'compatible' 的副作用。
{仅当编译时加入 +eval 特性才有效}{option} 的地方，可以使用 "t_xx" 形式来设置终端选项。这些选项覆盖相应的
termcap 值。设置后，可以用于映射。如果 "xx" 包含特殊字符，须用 <t_xx> 形式:
:set <t_#4>=^[Ot
也可用来翻译普通键的特殊键码。例如，如果 Alt-b 产生 <Esc>b，可用:
:set <M-b>=^[b
(这里 ^[ 是真正的 <Esc>，用 CTRL-V <Esc> 来输入)
这个方法优于映射之处在于它能适用于所有情况。
为了安全原因，t_xx 选项不能在 |modeline| 或者 |sandbox| 里设置。
":set" 给出的列表看起来和 Vi 不同。长字符串选项在列表底部。而选项的数量也相当
多。"set all" 的输出可能一整屏都放不下，此时 Vim 会给出 |more-prompt|。
*option-backslash*
在字符串选项值中，如果要包含空白，一定要用反斜杠前导。如果要包含单个反斜杠，一
定要输入两个。换而言之，选项值里的反斜杠数目会减半 (往下取整)。
这里有一些例子:
:set tags=tags\ /usr/tags 产生 "tags /usr/tags"
:set tags=tags\\,file 产生 "tags\,file"
:set tags=tags\\\ file 产生 "tags\ file"
:set titlestring=hi\|there
而要把 'titlestring' 选项设为 "hi" 并把 'iconstring' 设为 "there":
:set titlestring=hi|set iconstring=there
:set titlestring=hi\ \"there\"
:set dir=\\machine\path 产生 "\\machine\path"
:set dir=\\\\machine\\path 产生 "\\machine\path"
:set dir=\\path\\file 产生 "\\path\file" (错了！)
第一个例子的开始部分被保持，但第二个的反斜杠被减半。这样可以确保在你期望反斜杠
减半和反斜杠保持原样的两种情况都能工作。第三个的结果也许不是你想要的。避免这种
用法。
*add-option-flags* *remove-option-flags*
*E539* *E550* *E551* *E552*
有些选项是标志位的列表。如果你想给这样的选项加入标志位而不影响已有的，可以:
:set guioptions+=a
从选项里删除标志位可以用:
:set guioptions-=a
这样就删除 'guioptions' 里的 'a' 标志位。
注意 一次只应该只加减一个标志位。如果 'guioptions' 的值是 "ab"，不能用
"set guioptions-=ba"，因为字符串 "ba" 没有出现。
*:set_env* *expand-env* *expand-environment-var*
若干字符串选项扩展环境变量。如果某环境变量存在，'$' 后跟该环境变量的名字被替换
为它的值。如果不存在，'$' 和该名字不会被修改。任何非标识符的字符 (不是字母，数
字或 '_') 都可以跟在环境变量名字的后面。该字符和其后的内容附加于环境变量的值之
后。比如:
:set term=$TERM.new
:set path=/usr/$INCLUDE,$HOME/include,.
如果用 ":set opt-=val" 或 ":set opt+=val" 从选项里加减字符串，该扩展在加入或删
除操作之前完成。
局部选项的处理 *local-options*
有的选项只适用于单个窗口或缓冲区。每个窗口或缓冲区有该选项的单独版本，因而分别
拥有不同的值。这样便可以在一个窗口置位 'list'，而另一个不置位。又或者在一个缓
冲区设置 'shiftwidth' 为 3 而另一个设置为 4。
下面解释在一些特定情形下局部选项如何进行操作。其实，你无需了解所有的细节，因为
Vim 基本上依照你的想法使用这些选项值。不幸的是，要满足用户的要求并不简单 ...
分割窗口时，局部选项复制到新窗口。因而分割后，两个窗口的内容看起来一模一样。
编辑新缓冲区时需要初始化局部选项值。因为当前缓冲区的局部选项可能为它自己度身定
制，我们不能使用这些设置。相反，每个缓冲区局部选项都存在一个全局值，它们被用于
新缓冲区。":set" 同时修改局部和全局值。"setlocal" 只修改局部值而不影响将来编辑
新缓冲区时选项的设置。
如果要编辑的缓冲区过去曾经编辑过，重新应用它最近使用的窗口选项: 如果该缓冲区曾
经在本窗口编辑过，使用本窗口当时的值。否则使用该缓冲区上次编辑所在的窗口用过的
值。
一种类型的缓冲区可能有专门的窗口局部选项。同一个窗口要切换编辑的缓冲区时，你可
能因而不希望维持这些局部选项。为此，Vim 维护窗口局部选项的全局值，切换编辑的缓
冲区时使用全局值。每个窗口都有全局值的独立版本。因而这些值局部于窗口，但全局于
该窗口的所有缓冲区。这样，你可以用:
:e one
:set list
:e two
现在 'list' 选项也会在 "two" 里置位，因为 ":set list" 命令同时置位全局值。
:set nolist
:e one
:setlocal list
:e two
现在 'list' 选项不被置位，因为 ":set nolist" 复位全局值，而 ":setlocal list"
只改变局部值，但 ":e two" 又使用全局值。注意 如果你接下来这么做:
:e one
你不会得到上次编辑 "one" 时的 'list' 值。不会为每个缓冲区分别记住局部于窗口的
选项。
*:setl* *:setlocal*
:setl[ocal] ... 类似于 ":set"，但只设置局部于当前缓冲区或者窗口的值。
不是所有的选项都有局部值的。如果该选项没有局部值，那么
那么设置全局值。
如果用 "all" 参数: 显示所有局部选项的局部值。
如果没有参数: 显示所有不同于缺省的局部选项的局部值。
显示局部选项时，显示它的局部值。而全局选项则显示全局值
(将来或许会有所改变)。
{Vi 无此功能}{option}< 通过复制全局值，把 {option} 的局部值设回它的全局值。
{Vi 无此功能}{option}< 通过使之为空，把 {option} 的局部值设回它的全局值。只对
|global-local| 选项有意义。
{Vi 无此功能}{Vi 无此功能} 命令 全局值 局部值
:set option=value 设置 设置
:setlocal option=value - 设置
:setglobal option=value 设置 -
:set option? - 显示
:setlocal option? - 显示
:setglobal option? 显示 -
有局部值的全局选项 *global-local*
选项之所以定义为全局类型，是因为多数情况下它们在所有缓冲区和窗口里只需设置一个
值。但对有些全局选项而言，定义不同的局部值可能有用。你可以使用 ":setlocal" 来
设置这些全局选项的局部值。此时，该缓冲区或窗口使用局部值，而其它缓冲区和窗口继
续使用全局值。
例如，你有两个窗口，都在编辑 C 源代码，也都使用全局的 'makeprg' 选项。如果其中
一个这么做:
:set makeprg=gmake
那么另一个窗口也会切换到新值。无需再为那个 C 源代码窗口重复设置一遍 'makeprg'
选项。
不过，如果你在新窗口里编辑 Perl 脚本而想让它使用别的 'makeprg'，但你又不想改变
C 源代码使用的值。可用这个命令:
:setlocal makeprg=perlmake
只要把局部值设为空，你就可以切换回全局值:
:setlocal makeprg=
这只适用于字符串选项。布尔型选项需要使用 "<" 标志:
:setlocal autoread<
要 注意，对非布尔型的选项使用 "<" 会把全局值复制给局部值，而不是切换到直接使用
全局值的情形 (如果后来又改变全局值，就能看出两者的区别了)。也可用:
:set path<
这样做会使 'path' 的局部值为空并从而使用它的全局值。它和下行的效果相同:
:setlocal path=
注意: 更多的全局选项将来可能会成为全局-局部类型。那时，在全局选项上使用
":setlocal" 的效果能会有不同。
设置文件类型
:setf[iletype] {filetype} *:setf* *:setfiletype*
把 'filetype' 选项设为 {filetype}。但如果已经在 (嵌套)
自动命令序列中设置过，就不再进行。
等价于下面代码的缩写:
:if !did_filetype()
: setlocal filetype={filetype}
:endif
在一个 filetype.vim 里使用该命令可避免设置 'filetype'
选项两次，导致不同的设置和语法文件被载入。
{Vi 无此功能}<CR>，会打开帮
助窗口来提供该选项更多的帮助。
修改选项的值，然后在 "set" 行上按 <CR> 就会设置新值。
对于窗口和缓冲区特定的选项，设置的是最近访问窗口里的选
项值。除非它是帮助窗口，这时使用帮助窗口下方的窗口 (选
项窗口本身不算)。
{仅当编译时加入 |+eval| 和 |+autocmd| 特性才有效}
*$HOME*
使用 "~" 如同使用 "$HOME"，但只有在选项开头和空格或逗号之后才会识别。
Unix 系统上也可以用 "~user"。它被用户 "user" 的主目录代替。例如:
:set path=~mool/include,/usr/include,.
{HOME}" 形式。这时，{} 之间的名字可以包含非标识符字符。
注意 如果你想为 "gf" 命令使用这种形式，'{' 和 '}' 字符需要加到 'isfname' 里。
注意: 环境变量和 "~/" 的扩展只在 ":set" 命令里进行，给选项赋值的 ":let" 不会。
注意 扩展后的选项的最大长度有限制。具体多少与系统有关，一般是 256 或 1024 个字
符这样的数目。
*:fix* *:fixdel*
:fix[del] 设置 't_kD' 的值，如果:
't_kb' 是 't_kD' 就变成
CTRL-? CTRL-H
非 CTRL-? CTRL-?
(CTRL-? 是 0177 八进制、0x7f 十六进制) {Vi 无此功能} :fixdel
不管退格键的实际代码是什么，它都能工作。
如果退格键的终端代码不对，可以用:
:if &term == "termname"
: set t_kb=^V<BS>
: fixdel
:endif
这里 "^V" 是 CTRL-V 而 "<BS>" 是退格键 (不要输入四个字
符！)。把 "termname" 换成你的终端名字。
如果 <Delete> 键发送一个奇怪的键序列 (不是 CTRL-? 或
CTRL-H)，不要用 ":fixdel"，而应该:
:if &term == "termname"
: set t_kD=^V<Delete>
:endif
这里 "^V" 是 CTRL-V 而 "<Delete>" 是删除键 (不要输入八
个字符！)。把 "termname" 换成你的终端名字。
*Linux-backspace*
Linux 的备注: 退格键缺省产生 CTRL-?，这是错的。在
rc.local 里放上这行可以修正:
echo "keycode 14 = BackSpace" | loadkeys
*NetBSD-backspace*
NetBSD 的备注: 如果退格键产生错误的键码，可试用:
xmodmap -e "keycode 22 = BackSpace"
如果可以，在 .Xmodmap 文件里加入:
keysym 22 = BackSpace
要使之生效，你需要重启。
除了用 ":set" 命令设置选项以外，还有三个方法可以自动设置一个或多个文件的选项:
1. 启动 Vim 时，在若干地方可以进行初始化，见 |initialization|。多适用于所有编
辑会话。有些则取决于 Vim 启动时所在目录。你可以用 |:mkvimrc|、|:mkview| 和
|:mksession| 创建初始化设置。
2. 开始编辑新文件时，会执行自动命令。这里可以为匹配一定模式的文件设置选项和做
其它的事，见 |autocommand|。
3. 开始编辑新文件并且打开 'modeline' 选项时，在文件开始和结束处的一些行上检查
模式行。下面解释此机制。
*modeline* *vim:* *vi:* *ex:* *E520*
有两种模式行。第一种形式:
[text]{white}{vi:|vim:|ex:}[white]{options}
[text] 任何文本，可以为空
{white} 不少于一个的空白字符 (<Space> 或 <Tab>)
{vi:|vim:|ex:} 字符串 "vi:"、"vim:" 或 "ex:"
[white] 可选的空白字符
{options} 选项设置的列表，用空格或 ':' 分隔。每个 ':' 之间的部分成为一个
":set" 命令的参数 (可为空)
例如:
vi:noai:sw=3 ts=6
第二种形式 (和部分版本的 Vi 兼容):
[text]{white}{vi:|vim:|ex:}[white]se[t] {options}:[text]
[text] 任何文本，可以为空
{white} 不少于一个的空白字符 (<Space> 或 <Tab>)
{vi:|vim:|ex:} 字符串 "vi:"、"vim:" 或 "ex:"
[white] 可选的空白字符
se[t] 字符串 "set " 或 "se " (注意 空格)
{options} 选项列表，以空白分隔。每个部分成为一个 ":set" 命令的参数
: 冒号
[text] 任何文本，可以为空
例如:
/* vim: set ai tw=75: */
{vi:|vim:|ex:} 之前的空格是必要的。这样可以减少错用比如 "lex:" 这样的普通单词
的可能性。有一个特例: "vi:" 和 "vim:" 也可以出现在行首 (为和 3.0 版本兼容)。
在行首使用 "ex:" 会被忽略 (这可以是 "example:" 的缩写)。
*modeline-local*
选项的设置类似于 ":setlocal": 新值只适用于包含该文件的缓冲区和窗口。尽管可以从
模式行里设置全局值，这非常罕见。如果你打开两个窗口，而其中的两个文件为同一个全
局值设置不同的值，结果取决于哪个文件后打开。
编辑已经载入的文件时，只使用模式行里局部于窗口的选项。因而，如果打开文件后你手
动修改局部于缓冲区的选项，在别的窗口里编辑相同的缓冲区不会改变这些选项。但局部
于窗口的选项会被设置。
*modeline-version*
如果模式行只用于某些版本的 Vim，版本号应在使用 "vim:" 时指定:
vim{vers}: {vers} 版本或更高
vim<{vers}: {vers} 之前的版本
vim={vers}: {vers} 版本
vim>{vers}: {vers} 之后的版本
对于 Vim 6.0，{vers} 是 600 (主版本号乘一百加副版本号)。
例如，要设置 Vim 6.0 或以后版本使用的模式行:
/* vim600: set foldmethod=marker: */
要为 Vim 5.7 以前的版本设置模式行:
/* vim<570: set sw=4: */
"vim" 和 ":" 之间不能有空格。
检查的行数用 'modelines' 选项设置。如果关闭 'modeline' 或者 'modelines' 为零，
不检查模式行。
注意 第一种形式使用该行的其余部分。所以这行:
/* vi:ts=4: */
会指出拖尾的 "*/" 是一个错误。这样就可以:
/* vi:set ts=4: */
如果检测到错误，忽略该行的其余部分。
如果你想在 set 命令里包含 ':'，在冒号之前加上 '\'。处理时，':' 之前的反斜杠会
被删除。例如:
/* vi:set dir=c\:\tmp: */
会设置 'dir' 选项为 "c:\tmp"。':' 之前只删除一个反斜杠。因此，要包含 "\:" 你需
要指定 "\\:"。
为了安全原因，除了 "set" 以外，不支持别的命令 (有人可能会用模式行创建一个文本
的特洛伊木马文件)。而且也不是所有选项都可设置。对有些选项而言，会设置一个标志
位来激活 |sandbox|。即便如此，使用模式行还是有些微风险。例如，如果有些开玩笑的
人设置 'textwidth' 为 5，你的所有行都会意想不到地被回绕。因此，在编辑一些不信
任的文本时不妨关闭模式行。例如，mail 文件类型插件就这么做。
提示: 除了设置选项以外，如果你需要做别的事情，可以定义自动命令并检查文件是否包
含特定字符串。例如:
au BufReadPost * if getline(1) =~ "VAR" | call SetVar() | endif
并且定义函数 SetVar()，为包含 "VAR" 行的文件做一些事。
下表给出所有选项，包括全名和，如果有的话，它们的缩写。可任意使用两种形式。
本文档里，布尔型选项的 "置位" 意味着输入 ":set option"。选项的 "复位" 意味着使
用 ":set nooption"。
有些选项有两个缺省值: "Vim 缺省" 在没有置位 'compatible' 时使用，而 "Vi 缺省"
在置位 'compatible' 时使用。
多数选项适用于所有的窗口和缓冲区。有一些专用于设置窗口里如何显示文本。每个窗口
可以为它们设置不同的值。比如 'list' 选项，可以在一个窗口置位而在显示相同文本的
另一个窗口复位，这样你就可以同时看到两种视图。有一些选项专用于特定的文件。它们
可以为每个文件或者缓冲区设置不同的值。比如 'textwidth' 选项可以在普通的文本文
件里设为 78，而在 C 程序里设为 0。
全局 所有缓冲区和窗口使用同一个选项值
局部于窗口 每个窗口有自己的选项值
局部于缓冲区 每个缓冲区有自己的选项值
如果创建一个新窗口，使用当前活动的窗口的选项值作为窗口专用选项的缺省值。缓冲区
专用的选项取决于 'cpoptions' 选项的 's' 和 'S' 标志位。如果包含 's' (缺省)，那
么缓冲区在第一次进入时，从当前活动的缓冲区复制选项值。如果包含 'S'，每次进入缓
冲区都会复制选项的值。这样，和全局选项几乎没有区别。如果 's' 和 'S' 都不存在，
缓冲区在建立时从当前活动的缓冲区复制选项。
隐藏选项 *hidden-options*
不是所有版本都支持所有的选项。这取决于哪些特性得到支持，有时和系统也有关。下面
在花括号里提供这方面的评注。一个选项即使不支持也可以进行设置，这时并不会报错。
这些选项称为隐藏选项。不过，你无法取回隐藏选项的值，因为设置的值不会被保存。
要测试选项 "foo" 是否可用 ":set" 设置:
if exists('&foo')
这里，隐藏选项也返回真。要测试是否真的支持选项 "foo":
if exists('+foo')
*E355*
|Q_op| 提供包含简短描述的选项列表，可用它进行跳转。
*'aleph'* *'al'* *aleph* *Aleph*
'aleph' 'al' 数值型 (MS-DOS 的缺省为 128，否则为 224)
全局
{Vi 无此功能}{仅当编译时加入 |+rightleft| 特性才有效}
希伯来字母表的第一个字母的 ASCII 码。希伯来模式下的键盘映射例程，包括
插入模式 (如果置位 hkmap) 和命令行模式 (如果按了 CTRL-_)，都使用
[aleph..aleph+26] 范围输出希伯来字符。
aleph=128 适用于 PC 代码，而 aleph=224 适用于 ISO 8859-8。
见 |rileft.txt|。
*'allowrevins'* *'ari'* *'noallowrevins'* *'noari'*
'allowrevins' 'ari' 布尔型 (缺省关闭)
全局
{Vi 无此功能}{仅当编译时加入 |+rightleft| 特性才有效}
允许插入和命令行模式使用 CTRL-_。缺省是关闭的，以免用户想输入 SHIFT-_
时不小心输入 CTRL-_ 而进入反向插入模式又不知道怎么退出。见 'revins'。
注意: 如果置位 'compatible'，该选项被复位。
*'altkeymap'* *'akm'* *'noaltkeymap'* *'noakm'*
'altkeymap' 'akm' 布尔型 (缺省关闭)
全局
{Vi 无此功能}{仅当编译时加入 |+farsi| 特性才有效}
如果打开，第二语言是波斯语。编辑模式下如果打开 'allowrevins' 的话，
CTRL-_ 切换波斯语和英语的键盘映射表。
如果关闭，在希伯来语和英语之间切换键盘映射表。可用于以原始方式，即英语
(从左到右模式)，启动 Vim，又可以使用第二语言即波斯语或者希伯来语 (从右
到左模式) 的场合。见 |farsi.txt|。
*'ambiwidth'* *'ambw'*
'ambiwidth' 'ambw' 字符串 (缺省: "single")
全局
{Vi 无此功能}{仅当编译时加入 |+multi_byte| 特性才有效}
只有在 'encoding' 为 "utf-8" 或别的 Unicode 编码时才有效。告诉 Vim 怎
么处理东亚二义性宽度字符类 (East Asian Width Class Ambiguous) (例如
欧元符号、注册记号、版权记号、希腊字母、西里尔字母等等)。
目前有两个可能的选择:
"single": 使用和 US-ASCII 字符相同的宽度。多数用户希望如此。
"double": 使用 US-ASCII 字符两倍的宽度。
在一些 CJK 字体里，这些字符的字形宽度完全由它们在传统的 CJK 编码里占据
字节的数目决定。那些编码中，欧元、注册记号、希腊/西里尔字母等占据两个
字节，因而它们在这些字体里用 "宽" 字形显示。这也包括文本文件里制表用的
一些画线字符。因此如果 GUI Vim 使用 CJK 字体、或者在使用 CJK 字体的终
端 (模拟器) (包括带有 "-cjkwidth" 选项的 xterm) 里运行 Vim，应把该选项
设为 "double"，这样可以匹配这些字体里 Vim 实际看到相关字形的宽度。 CJK
Windows 9x/ME 或 Windows 2k/XP 上，如果系统 locale 为 CJK locale，也应
把本选项设为 "double"。见 Unicode Standard Annex #11
(http://www.unicode.org/reports/tr11)。
*'antialias'* *'anti'* *'noantialias'* *'noanti'*
'antialias' 'anti' 布尔型 (缺省: 关闭)
全局
{Vi 无此功能}{仅当编译时加入 Mac OS X 的 GUI 支持才有效}{Vi 无此功能}注意: 打开次选项会使得某些插件无法工作。
*'arabic'* *'arab'* *'noarabic'* *'noarab'*
'arabic' 'arab' 布尔型 (缺省关闭)
局部于窗口
{Vi 无此功能}{仅当编译时加入 |+arabic| 特性才有效}
可以置位本选项来开始编辑阿拉伯文本。
置位本选项会:
- 置位 'rightleft' 选项，除非置位 'termbidi'。
- 置位 'arabicshape' 选项，除非置位 'termbidi'。
- 设置 'keymap' 选项为 "arabic"；插入模式下 CTRL-^ 会切换英语和阿拉伯
键盘映射。
- 置位 'delcombine' 选项。
注意 要使用阿拉伯文本，'encoding' 必须是 "utf-8"。
复位本选项会:
- 复位 'rightleft' 选项。
- 关闭 'keymap' 的使用 (但不改变其值)。
注意 这里不复位 'arabicshape' 和 'delcombine' (这些是全局选项)。
另见 |arabic.txt|。
*'arabicshape'* *'arshape'*
*'noarabicshape'* *'noarshape'*
'arabicshape' 'arshape' 布尔型 (缺省打开)
全局
{Vi 无此功能}{仅当编译时加入 |+arabic| 特性才有效}
如果打开且 'termbidi' 关闭，启动必须的可见字符的校正，以正确显示阿拉伯
语言。本质上它打开了字型重整；这是一个广义的术语，它包括:
a) 根据词内位置 (开头、中间、结尾和单独出现) 改变/调整字符的形状。
b) 启动合成字符的能力
c) 启动一些字符所需的组合
如果关闭，字符显示回复到每个字符单独显示的方式。
阿拉伯语是一个复杂的语言，还需要其他的设置。详见 |arabic.txt|。
*'autoindent'* *'ai'* *'noautoindent'* *'noai'*
'autoindent' 'ai' 布尔型 (缺省关闭)
局部于缓冲区
开启新行时 (插入模式下输入 <CR>，或者使用 "o" 或 "O" 命令)，从当前行复
制缩进距离。如果你在新行除了 <BS> 或 CTRL-D 以外不输入任何东西，然后输
入 <Esc>、CTRL-O 或 <CR>，缩进又被删除。移动光标到其它行也有同样的效
果，除非 'cpoptions' 里包含 'I' 标志位。
如果打开自动缩进，排版 (用 "gq" 命令或者插入模式下到达了 'textwidth')
使用第一行的缩进距离。
打开 'smartindent' 或 'cindent' 时，缩进的修改方式有所不同。
置位 'paste' 选项时，'autoindent' 选项被复位。
{Vi 稍有不同: Vim 里输入 <Esc> 或 <CR> 删除缩进后，上下移动把光标放在
删除的缩进之后；Vi 则把光标放在已删除的缩进的某处}。
*'autoread'* *'ar'* *'noautoread'* *'noar'*
'autoread' 'ar' 布尔型 (缺省关闭)
全局或局部于缓冲区 |global-local|
{Vi 无此功能} :set autoread<
*'autowrite'* *'aw'* *'noautowrite'* *'noaw'*
'autowrite' 'aw' 布尔型 (缺省关闭)
全局
自动把内容写回文件: 如果文件被修改过，在每个 :next、:rewind、:last、
:first、:previous、:stop、:suspend、:tag、:!、:make、CTRL-] 和 CTRL-^
命令时进行；用 :buffer、CTRL-O、CTRL-I、'{A-Z0-9} 或 `{A-Z0-9} 命令转
到别的文件时亦然。
注意 有些命令不使用 'autowrite' 选项。为此目的，可用 'autowriteall'。
*'autowriteall'* *'awa'* *'noautowriteall'* *'noawa'*
'autowriteall' 'awa' 布尔型 (缺省关闭)
全局
{Vi 无此功能}{Vi 无此功能} :set background&
Vim 会猜测其值。GUI 里应该没有问题，其它情况下 Vim 可能不一定能猜对。
启动 GUI 时，'background' 的缺省值是 "light"。如果 .gvimrc 里没有设置
该值，而 Vim 检测到背景实际上很深，'background' 会设为 "dark"。但这在
.gvimrc 读入_之后_才发生 (因为窗口需要被打开才能发现实际的背景色)。要
避免这一点，在 .gvimrc 里放上 ":gui" 命令以强迫打开 GUI 窗口。它应在使
用 'background' 的值的命令之前 (比如，在 ":syntax on" 之前)。通常，该
选项应在 .vimrc 文件里设置。可能和终端的名字有关。比如:
:if &term == "pcterm"
: set background=dark
:endif
如果设置该选项，高亮组的缺省设置会发生改变。要进行其它设置，在设置
'background' 选项_之后_才使用 ":highlight" 命令。
该选项也在 "$VIMRUNTIME/syntax/syntax.vim" 文件里使用，用来选择语法高
亮的颜色。在改变此选项后，你必须再次载入 syntax.vim 才能看到效果。这可
以通过 ":syntax on" 完成。
*'backspace'* *'bs'*
'backspace' 'bs' 字符串 (缺省为 "")
全局
{Vi 无此功能}<BS>、<Del>、CTRL-W 和 CTRL-U 在插入模式下的工作方式。它是逗号分
隔的项目列表。每个项目允许一种退格删除的内容:
值 效果
indent 允许在自动缩进上退格
eol 允许在换行符上退格 (连接行)
start 允许在插入开始的位置上退格；CTRL-W 和 CTRL-U 到达插入开始的位
置时停留一次。
如果该值为空，使用 Vi 兼容的退格方式。
为了和 5.4 及更早的版本后向兼容:
值 效果
0 等同于 ":set backspace=" (Vi 兼容)
1 等同于 ":set backspace=indent,eol"
2 等同于 ":set backspace=indent,eol,start"
如果你的 <BS> 或 <Del> 键不合你的期望，见 |:fixdel|。
注意: 如果置位 'compatible'，该选项被设为 ""。
*'backup'* *'bk'* *'nobackup'* *'nobk'*
'backup' 'bk' 布尔型 (缺省关闭)
全局
{Vi 无此功能}注意: 如果置位 'compatible'，该选项被复位。
*'backupcopy'* *'bkc'*
'backupcopy' 'bkc' 字符串 (Vi 在 Unix 上的缺省: "yes"，否则: "auto")
全局
{Vi 无此功能}{Vi 无此功能} :set bdir=c:\\tmp,\ dir\\,with\\,commas,\\\ dir\ with\ spaces
- 为了和 Vim 3.0 版本后向兼容，本选项开头的 '>' 被删除。
另见 'backup' 和 'writebackup' 选项。
如果你需要在 Unix 上隐藏备份文件，考虑这样的值:
:set backupdir=./.backup,~/.backup,.,/tmp
要使之正确工作，你需要在每个目录和你的主目录里建立 ".backup" 目录。
建议使用 |:set+=| 和 |:set-=| 来从列表里加减目录。这可以避免未来版本使
用其它缺省值出现的问题。
为了安全原因，本选项不能在 |modeline| 或 |sandbox| 里设置。
*'backupext'* *'bex'* *E589*
'backupext' 'bex' 字符串 (缺省为 "~"，VMS 上: "_")
全局
{Vi 无此功能}<>" 都不合法。
如果你喜欢保留很多备份，可以用 BufWritePre 自动命令，使之在写入文件前
改变 'backupext'，以包含写入的时间。
:au BufWritePre * let &bex = '-' . strftime("%Y%b%d%X") . '~'
'backupdir' 可用来把备份放在不同的目录里。
*'backupskip'* *'bsk'*
'backupskip' 'bsk' 字符串 (缺省: "/tmp/*,$TMPDIR/*,$TMP/*,$TEMP/*")
全局
{Vi 无此功能}{仅当编译时加入 |+wildignore| 特性才有效}
文件名模式列表。如果其中某个模式匹配要写入的文件名，不建立它的备份文
件。同时测试指定的文件名和它的完整路径名。模式的使用方式和 |:autocmd|
类同，见 |autocmd-patterns|。
小心特殊字符，见 |option-backslash|。
如果没有定义 $TMPDIR、$TMP 或 $TEMP，缺省值就不包含它们。"/tmp/*" 只用
于 Unix。
注意 这里不扩展环境变量。如果你想要用 $HOME，必须显式地对其扩展，例
如:
:let backupskip = escape(expand('$HOME'), '\') . '/tmp/*'
注意 缺省值也确保 "crontab -e" 能工作 (如果给原来文件换名来建立备份，
crontab 不会看到新建立的文件)。另见 'backupcopy' 和 |crontab|。
*'balloondelay'* *'bdlay'*
'balloondelay' 'bdlay' 数值型 (缺省: 600)
全局
{Vi 无此功能}{仅当编译时加入 |+balloon_eval| 特性才有效}
弹出气泡之前以毫秒计的延迟。见 |balloon-eval|。
*'ballooneval'* *'beval'* *'noballooneval'* *'nobeval'*
'ballooneval' 'beval' 布尔型 (缺省关闭)
全局
{Vi 无此功能}{仅当编译时加入 |+balloon_eval| 特性才有效}
打开 |balloon-eval| 功能。
*'balloonexpr'* *'bexpr'*
'balloonexpr' 'bexpr' 字符串 (缺省 "")
全局或局部于缓冲区 |global-local|
{Vi 无此功能}{仅当编译时加入 |+balloon_eval| 特性才有效}
计算气泡显示文本的表达式。只在 'ballooneval' 打开时才使用。它用到以下
变量:
v:beval_bufnr 要显示气泡的缓冲区号
v:beval_winnr 窗口编号
v:beval_lnum 行号
v:beval_col 列号 (字节位置)
v:beval_text 鼠标指针所在或之后的单词
表达式的计算不能有副作用！
例如:
function! MyBalloonExpr()
return 'Cursor is at line ' . v:beval_lnum .
\', column ' . v:beval_col .
\ ' of file ' . bufname(v:beval_bufnr) .
\ ' on word "' . v:beval_text . '"'
endfunction
set bexpr=MyBalloonExpr()
set ballooneval
注意: 只有光标在文本字符上的时候才会显示气泡。如果 'balloonexpr' 的计
算结果非空，Vim 不会试图发送消息给外部调试器 (Netbeans 或 Sun
Workshop)。
表达式的计算可能在沙盘 |sandbox| 里进行，见 |sandbox-option|。
计算 'balloonexpr' 时，不能改变文本或跳到别的窗口 |textlock|。
要检查气泡文本是否可以包含换行符:
if has("balloon_multiline")
如果支持，"\n" 字符开启新行。如果表达式计算结果为 |List|，这相当于把每
个列表项目当作字符串，然后之间用 "\n" 连接。
*'binary'* *'bin'* *'nobinary'* *'nobin'*
'binary' 'bin' 布尔型 (缺省关闭)
局部于缓冲区
{Vi 无此功能}<NL> 分隔行)。
不会使用 'fileencoding' 和 'fileencodings' 选项。文件读取不经过转换。
注意: 如果 'bin' 选项已经打开而你开始编辑 (另) 一个文件，自动命令的设
置可能会再次改变这些相关的设置 (比如，'textwidth')，使得编辑出现麻烦。
因而，载入文件时，你可以再次置位 'bin'。
这些选项以前的值被记住，'bin' 从开到关时会复原它们。每个缓冲区都有一组
保存的选项值。
要使用 'binary' 编辑文件，你可以使用 |++bin| 参数。这样你不用输入
":set bin"，而后者会影响所有你编辑的文件。
写回文件时，只有原来文件本就包含时才写入末行的 <EOL> (通常，如果末行
没有 <EOL>，Vim 会附加一个；这样文件会变长)。见 'endofline' 选项。
*'bioskey'* *'biosk'* *'nobioskey'* *'nobiosk'*
'bioskey' 'biosk' 布尔型 (缺省打开)
全局
{Vi 无此功能}{仅适用于 MS-DOS}CTRL-C 更有效，但只适用于控
制台模式。如果在通过窗口连接的终端上使用，复位此选项。
另见 |'conskey'|。
*'bomb'* *'nobomb'*
'bomb' 布尔型 (缺省关闭)
局部于缓冲区
{Vi 无此功能}{仅当编译时加入 |+multi_byte| 特性才有效}
写入文件时，如果满足以下条件，在文件头部写入 BOM (Byte Order Mark，字
节顺序标记):
- 打开本选项
- 关闭 'binary' 选项
- 'fileencoding' 是 "utf-8"、"ucs-2"、"ucs-4" 或它们的 little/big
endian (高位在右侧/左侧的字节序) 变种。
有些应用程序使用 BOM 识别文件的编码。通常用于 MS-Windows 上的 UCS-2
文件。对别的程序而言，这会造成麻烦，比如: "cat file1 file2" 使得 file2
的 BOM 出现在结果文件的中间。
读入文件时，如果 'fileencodings' 以 "ucs-bom" 开头，Vim 会检查 BOM 是
否存在，并相应地设置 'bomb'。
除非置位 'binary'，BOM 会从首行上移去，所以编辑时你看不到它。如果你没
有改变相应设置，写回文件时恢复 BOM。
*'breakat'* *'brk'*
'breakat' 'brk' 字符串 (缺省为 " ^I!@*-+;:,./?")
全局
{Vi 无此功能}{仅当编译时加入 |+linebreak| 特性才有效}
如果打开 'linebreak'，本选项让你选择可以在什么字符上换行。只能用 ASCII
字符，但如果 'encoding' 是 8 位编码，也可以用 8 位的字符。
*'browsedir'* *'bsdir'*
'browsedir' 'bsdir' 字符串 (缺省为 "last")
全局
{Vi 无此功能}{仅适用于 Motif 和 Win32 GUI}{path} 使用指定目录。
*'bufhidden'* *'bh'*
'bufhidden' 'bh' 字符串 (缺省: "")
局部于缓冲区
{Vi 无此功能}{仅当编译时加入 |+quickfix| 特性才有效}
本选项指定缓冲区不再出现于窗口时的行为:
<empty> 跟随全局 'hidden' 选项
hide 隐藏缓冲区 (不卸载)，即使没有置位 'hidden' 也如此
unload 卸载缓冲区，即使置位 'hidden' 或者使用 |:hide| 时也如
此
delete 从缓冲区列表里删除缓冲区，即使置位 'hidden' 或者使用
|:hide| 时也如此，类似于 |:bdelete|
wipe 从缓冲区列表里真正删除缓冲区，即使置位 'hidden' 或者使
用 |:hide| 时也如此，类似于 |:bwipeout|
小心: 使用 "unload"、"delete" 或 "wipe" 后，缓冲区的修改会丢失而且没有
警告。
本选项和 'buftype' 和 'swapfile' 一起使用，指定特殊的缓冲区的类型。见
|special-buffers|。
*'buflisted'* *'bl'* *'nobuflisted'* *'nobl'* *E85*
'buflisted' 'bl' 布尔型 (缺省: 打开)
局部于缓冲区
{Vi 无此功能}{Vi 无此功能}{仅当编译时加入 |+quickfix| 特性才有效}
本选项的值指定缓冲区的类型:
<empty> 普通缓冲区
nofile 和文件不相关且不会写回的缓冲区
nowrite 不会写回的缓冲区
acwrite 缓冲区总是用 BufWriteCmd 自动命令写回 {仅当编译时加入
|+autocmd| 特性才有效}
quickfix quickfix 缓冲区，包含错误列表 |:cwindow| 或位置列表
|:lwindow|
help 帮助缓冲区 (你不应该手动设置本值)
本选项和 'bufhidden' 和 'swapfile' 一起使用，指定特殊的缓冲区类型。见
|special-buffers|。
修改本选项要小心。它有很多副作用！
"quickfix" 缓冲区只用于错误列表和位置列表。用 |:cwindow| 和 |:lwindow|
命令设置本值，不要直接修改它。
"nofile" 和 "nowrite" 缓冲区很类似:
都是: 缓冲区不写回磁盘。":w" 不能工作 (":w filename" 仍然可
以)。
都是: 缓冲区永远不会认为是 |'modified'| (修改过的)。
没有警告说改变会丢失，即使你退出 Vim 时也是如此。
都是: 交换文件只有在使用超量内存时才会建立 (如果复位
'swapfile'，无论如何也不会有交换文件)。
只限 nofile: 缓冲区名是固定的，不被视为文件名来处理。|:cd| 命令也不
会修改它。
*E676*
"acwrite" 隐含意味着缓冲区名和文件不相关，类似于 "nofile"，但它会被写
回。所以，和 "nofile" 与 "nowrite" 不同，可以 ":w" 而且修改过的缓冲区
没有保存不能被放弃。写入操作要有匹配的 |BufWriteCmd|、|FileWriteCmd|
和 |FileAppendCmd| 自动命令。
*'casemap'* *'cmp'*
'casemap' 'cmp' 字符串 (缺省: "internal,keepascii")
全局
{Vi 无此功能}{仅当编译时加入 |+multi_byte| 特性才有效}
指定改变字母大小写的细节。它包含以下单词，以逗号分隔:
internal 使用内部大小写映射函数，当前的 locale 不改变大小写映
射。这只影响 'encoding' 为 Unicode 编码、"latin1" 或
"iso-8859-15" 的情况。如果没有 "internal"，使用系统库
函数 (如果有的话) towupper() 和 towlower()。
keepascii ASCII 字符 (0x00 到 0x7f)，使用美国的大小写映射，当前
locale 不起作用。这可能只影响土耳其语。
*'cdpath'* *'cd'* *E344* *E346*
'cdpath' 'cd' 字符串 (缺省: 等价于 $CDPATH 或 ",,")
全局
{Vi 无此功能}{仅当编译时加入 |+file_in_path| 特性才有效}
这是一个目录列表。使用 |:cd| 和 |:lcd| 命令时，如果要查找相对路径 (不
以 "/"、"./" 或 "../" 开始)，在这里搜索目录。
'cdpath' 选项的值和 |'path'| 有相同的形式和语义。另见
|file-searching|。
缺省值取自 $CDPATH，并在前面附加 ","，以便先搜索当前目录。
如果取自 $CDPATH 的缺省值不是你想要的，在 vimrc 文件里加入下面命令的修
改版本以覆盖之:
:let &cdpath = ',' . substitute(substitute($CDPATH, '[, ]', '\\\0', 'g'), ':', ',', 'g')
为了安全原因，本选项不能在 |modeline| 或 |sandbox| 里设置。
('cdpath' 的内容可传递给外壳以便扩展文件名)。
*'cedit'*
'cedit' 字符串 (Vi 缺省: ""，Vim 缺省: CTRL-F)
全局
{Vi 无此功能}{仅当编译时加入 |+vertsplit| 特性才有效}
用于命令行模式打开命令行窗口的键。
'compatible' 关闭时，缺省值为 CTRL-F。
只允许不可显示的键。
该键可以用单个字符的形式指定，但不易输入，建议使用 <> 记法。例如:
:set cedit=<C-Y>
:set cedit=<Esc>
|Nvi| 也有该选项，但只使用第一个字符。
见 |cmdwin|。
*'charconvert'* *'ccv'* *E202* *E214* *E513*
'charconvert' 'ccv' 字符串 (缺省为 "")
全局
{仅当编译时加入 |+multi_byte| 和 |+eval| 特性才有效}
{Vi 无此功能} set charconvert=CharConvert()
fun CharConvert()
system("recode "
\ . v:charconvert_from . ".." . v:charconvert_to
\ . " <" . v:fname_in . " >" v:fname_out)
return v:shell_error
endfun
相关的 Vim 变量是:
v:charconvert_from 当前的编码名
v:charconvert_to 期待的编码名
v:fname_in 输入文件名
v:fname_out 输出文件名
注意 v:fname_in 和 v:fname_out 永远不会相同。
注意 v:charconvert_from 和 v:charconvert_to 可能与 'encoding' 不同。
Vim 内部使用 UTF-8 代替 UCS-2 或 UCS-4。
使用 'charconvert' 时，Vim 不进行加密。如果你希望转换后加密文件，
'charconvert' 需要自己负责这一点。
为了安全原因，本选项不能在 |modeline| 或 |sandbox| 里设置。
*'cindent'* *'cin'* *'nocindent'* *'nocin'*
'cindent' 'cin' 布尔型 (缺省关闭)
局部于缓冲区
{Vi 无此功能}{仅当编译时加入 |+cindent| 特性才有效}
打开自动 C 程序缩进。'cinkeys' 说明如何设置插入模式下启动重新缩进的热
键，'cinoptions' 说明如何设置你喜欢的缩进风格。
如果 'indentexpr' 非空，它否决 'cindent' 的设置。
如果没有打开 'lisp'，而 'indentexpr' 和 'equalprg' 都为空，"=" 操作符
使用本算法缩进，而不调用外部程序。
见 |C-indenting|。
如果你不喜欢 'cindent' 的工作方式，可以试试 'smartindent' 选项或者
'indentexpr'。
如果置位 'paste'，不使用本选项。
注意: 如果置位 'compatible'，本选项被复位。
*'cinkeys'* *'cink'*
'cinkeys' 'cink' 字符串 (缺省为 "0{,0},0),:,0#,!^F,o,O,e")
局部于缓冲区
{Vi 无此功能}{仅当编译时加入 |+cindent| 特性才有效}
键列表，在插入模式输入这些键时，当前行被重新缩进。只有打开 'cindent'
而且 'indentexpr' 为空时才会用到。
本选项的格式见 |cinkeys-format|。
见 |C-indenting|。
*'cinoptions'* *'cino'*
'cinoptions' 'cino' 字符串 (缺省为 "")
局部于缓冲区
{Vi 无此功能}{仅当编译时加入 |+cindent| 特性才有效}
'cinoptions' 影响 'cindent' 重新缩进 C 程序行的方式。
|cinoptions-values| 说明如何设置本选项的值，而 |C-indenting| 提供总体
的 C 缩进方式的信息。
*'cinwords'* *'cinw'*
'cinwords' 'cinw' 字符串 (缺省为 "if,else,while,do,for,switch")
局部于缓冲区
{Vi 无此功能}{} 里)。
注意 'ignorecase' 对 'cinwords' 没有影响。如果希望忽略大小写，包含关键
字所有的大小写: "if,If,IF"。
*'clipboard'* *'cb'*
'clipboard' 'cb' 字符串 (X-windows 的缺省为
"autoselect,exclude:cons\|linux"，
其它为 "")
全局
{Vi 无此功能}{pattern}
定义用来匹配终端名 'term' 的模式。匹配的终端不连接到 X
服务器。可用于以下这种情形:
- 在控制台上运行 Vim，
- $DISPLAY 的设置使得应用程序在另一个显示上打开，
- 不希望在控制台上连接到 X 服务器，但希望在终端模拟器
上如此。
如果永远不想连接到 X 服务器，使用:
exclude:.*
这和 |-X| 参数的效果相同。
注意 如果没有到 X 服务器的连接，窗口标题不会复原，而剪
贴板也无法访问。
忽略 'magic' 的值，{pattern} 的解释总是假定 'magic' 打
开。
选项值的其余部分用于 {pattern}，本项目必须是最后一个项
目。
*'cmdheight'* *'ch'*
'cmdheight' 'ch' 数值型 (缺省为 1)
全局
{Vi 无此功能}{Vi 无此功能}{仅当编译时加入 |+vertsplit| 特性才有效}
命令行窗口的屏幕行数。|cmdwin|
*'columns'* *'co'* *E594*
'columns' 'co' 数值型 (缺省为 80 或终端宽度)
全局
{Vi 无此功能} :set columns=9999
最小值为 12，最大值为 10000。
*'comments'* *'com'* *E524* *E525*
'comments' 'com' 字符串 (缺省
"s1:/*,mb:*,ex:*/,://,b:#,:%,:XCOMM,n:>,fb:-")
局部于缓冲区
{Vi 无此功能}{仅当编译时加入 |+comments| 特性才有效}
逗号分隔的可以开始注释行的字符串列表。见 |format-comments|。
|option-backslash| 说明如何包含空格和使用反斜杠。
*'commentstring'* *'cms'* *E537*
'commentstring' 'cms' 字符串 (缺省为 "/*%s*/")
局部于缓冲区
{Vi 无此功能}{仅当编译时加入 |+folding| 特性才有效}
注释行的样板。该值里面的 "%s" 被注释文本替换。目前，只用于为折叠增加标
志。见 |fold-marker|。
*'compatible'* *'cp'* *'nocompatible'* *'nocp'*
'compatible' 'cp' 布尔型 (缺省打开，如果找到 |vimrc| 或 |gvimrc| 文件
则为关闭)
全局
{Vi 无此功能}注意: 这不适用于系统范围的
vimrc 或 gvimrc 文件，也不适用 -u 参数给定的文件)。另见
|compatible-default| 和 |posix-compliance|。
你也可以用 "-C" 参数置位此选项，或用 "-N" 复位。见 |-C| 和 |-N|。
关闭本选项使得有不同 Vi 和 Vim 缺省的选项使用 Vim 的缺省值。见下面 '+'
标注的选项。其它选项没有影响。
一旦打开此选项，若干其它选项会被置位或复位，使得 Vim 尽可能的和 Vi 兼
容。见下表。这可以用来回复到 Vi 兼容的编辑状态。
另见 'cpoptions'。
选项 + 设置值 效果
'allowrevins' 关闭 没有 CTRL-_ 命令
'backupcopy' Unix: "yes" 备份文件由复制产生
其它: "auto" 复制或者换名产生备份文件
'backspace' "" 普通的退格
'backup' 关闭 没有备份文件
'cindent' 关闭 不待开 C 代码的缩进
'cedit' + "" 没有打开 |cmdwin| 的键
'cpoptions' + (所有标志位) Vi 兼容的标志位
'cscopetag' 关闭 ":tag" 不使用 cscope
'cscopetagorder' 0 见 |cscopetagorder|
'cscopeverbose' 关闭 见 |cscopeverbose|
'digraph' 关闭 没有二合字母
'esckeys' + 关闭 插入模式不使用 <Esc> 开始键码的键
'expandtab' 关闭 制表不扩展为空格
'fileformats' + "" 没有自动的文件格式检测
"dos,unix" 除了 DOS、Windows 或 OS/2 外
'formatoptions' + "vt" Vi 兼容的排版选项
'gdefault' 关闭 ":s" 没有缺省的 'g' 标志位
'history' + 0 没有命令行历史
'hkmap' 关闭 没有希伯来语键盘映射
'hkmapp' 关闭 没有根据读音的希伯来语键盘映射
'hlsearch' 关闭 没有搜索匹配的高亮
'incsearch' 关闭 没有增量搜索
'indentexpr' "" 没有基于表达式的缩进
'insertmode' 关闭 不以插入模式启动
'iskeyword' + "@,48-57,_" 关键字包含字母数字和 '_'
'joinspaces' 打开 句号后插入两个空格
'modeline' + 关闭 没有模式行
'more' + 关闭 列表不暂停
'revins' 关闭 没有反向插入
'ruler' 关闭 没有标尺
'scrolljump' 1 滚动不跳跃
'scrolloff' 0 没有滚动偏移
'shiftround' 关闭 缩进不取整到 shiftwidth 的倍数
'shortmess' + "" 不缩短信息
'showcmd' + 关闭 不显示命令字符
'showmode' + 关闭 不显示当前模式
'smartcase' 关闭 没有忽略大小写的自动切换
'smartindent' 关闭 没有智能缩进
'smarttab' 关闭 没有智能制表大小
'softtabstop' 0 制表总是使用 'tabstop' 个位置
'startofline' 打开 一些命令到行首
'tagrelative' + 关闭 标签文件名不是相对的
'textauto' + 关闭 没有自动文本模式检测
'textwidth' 0 没有自动行回绕
'tildeop' 关闭 波浪符不是操作符
'ttimeout' 关闭 没有终端超时
'whichwrap' + "" 左右移动不回绕
'wildchar' + CTRL-E 只有在当前值为 <Tab> 时，使用 CTRL-E
用于命令行补全
'writebackup' 打开或关闭 取决于 +writebackup 特性
*'complete'* *'cpt'* *E535*
'complete' 'cpt' 字符串 (缺省: ".,w,b,u,t,i")
局部于缓冲区
{Vi 无此功能}CTRL-P 或 CTRL-N 时如何工
作，也用于整行的补全 |i_CTRL-X_CTRL-L|。它指示补全的类型和需要扫描的位
置。这是一个逗号分隔的标志位的列表:
. 扫描当前缓冲区 (忽略 'wrapscan')
w 扫描其它窗口的缓冲区
b 扫描其它缓冲区列表里载入的缓冲区
u 扫描缓冲区列表里卸载的缓冲区
U 扫描不在缓冲区列表里的缓冲区
k 扫描 'dictionary' 选项给出的文件
kspell 使用当前激活的拼写检查 |spell|
k{dict} 扫描文件 {dict}。可以给出多个 "k" 标志位，也可以使用模式。比
如:
:set cpt=k/usr/dict/*,k~/spanish
s 扫描 'thesaurus' 选项给出的文件
s{tsr} 扫描文件 {tsr}。可以给出多个 "s" 标志位，也可以使用模式。
i 扫描当前文件和包含的头文件
d 扫描当前文件和包含的头文件里的定义名或宏 |i_CTRL-X_CTRL-D|
] 标签补全
t 等同于 "]"
卸载的缓冲区不会载入，因而它们的自动命令 |:autocmd| 也不会执行，这使得
有些文件的补全效果出人意表 (比如 gzipped 压缩的文件)。整行补全也不会扫
描卸载的缓冲区。
缺省是 ".,w,b,u,t,i"，它意味着扫描:
1. 当前缓冲区
2. 其它窗口的缓冲区
3. 其它载入的缓冲区
4. 卸载的缓冲区
5. 标签
6. 头文件
如你所知，CTRL-N 和 CTRL-P 可用于完成任何基于 'iskeyword' 的扩展 (比如
字典 |i_CTRL-X_CTRL-K|、头文件里的模式 |i_CTRL-X_CTRL-I|、标签
|i_CTRL-X_CTRL-]| 和普通的扩展)。
*'completefunc'* *'cfu'*
'completefunc' 'cfu' 字符串 (缺省: empty)
局部于缓冲区
{Vi 无此功能}{仅当编译时加入 |+eval| 和 +insert_expand 特性才有效}
本选项指定插入模式补全 CTRL-X CTRL-U 使用的函数。|i_CTRL-X_CTRL-U|
|complete-functions| 解释如何调用该函数以及它应该返回何值。
*'completeopt'* *'cot'*
'completeopt' 'cot' 字符串 (缺省: "menu,preview")
全局
{仅当编译时加入 |+insert_expand| 特性才有效}
{Vi 无此功能}CTRL-L 来插入更
多的字符。是否忽略大小写取决于补全的类型。缓冲区文本使用
'ignorecase' 选项。
preview 在预览窗口里显示当前选择的补全的额外信息。只能和 "menu" 或
"menuone" 搭配使用。
*'confirm'* *'cf'* *'noconfirm'* *'nocf'*
'confirm' 'cf' 布尔型 (缺省关闭)
全局
{Vi 无此功能}{Vi 无此功能}{仅适用于 MS-DOS} 'conskey' 'bioskey' 行动
开 开关均可 直接控制台输入
关 开 BIOS
关 关 标准输入
*'copyindent'* *'ci'* *'nocopyindent'* *'noci'*
'copyindent' 'ci' 布尔型 (缺省关闭)
局部于缓冲区
{Vi 无此功能}注意: 如果置位 'compatible'，'copyindent' 被复位。
另见 'preserveindent'。
*'cpoptions'* *'cpo'*
'cpoptions' 'cpo' 字符串 (Vim 缺省: "aABceFs"，
Vi 缺省: 所有的标志位)
全局
{Vi 无此功能}注意: 如果置位 'compatible'，本选项被设为 Vi 的缺省值。相反，如果复位
'compatible'，本选项被设为 Vim 的缺省值。
注意: 如果应该使用 Vi 的缺省值且 $VIM_POSIX 环境变量存在时，本选项设为
POSIX 的缺省值 |posix|。这意味着行为尽量符合 POSIX 规范的要求。
包含 行为
*cpo-a*
a 如果包含，带文件名参数的 ":read" 命令会为当前窗口设置
轮换文件名。
*cpo-A*
A 如果包含，带文件名参数的 ":write" 命令会为当前窗口设置
轮换文件名。
*cpo-b*
b ":map" 命令里识别 "\|" 为 map 命令的结束。'\' 被包含在
映射里，'|' 之后的文本被解释为别的命令。使用 CTRL-V
代替反斜杠使 '|' 也包含在映射里。适用于所有的映射、缩
写、菜单和自动命令。
另见 |map_bar|。
*cpo-B*
B 映射、缩写和菜单命令的 "to" 部分里反斜杠没有特殊含义。
删除本标志位使得反斜杠的效果类似于于 CTRL-V。例如，命
令 ":map X \<Esc>" 使得 X 被映射为:
包含 'B' 时: "\^[" (^[ 是真正的 <Esc>)
排除 'B' 时: "<Esc>" (5 个字符)
(两种情况下都假定 '<' 标志位被排除)
*cpo-c*
c 搜索从任何光标所在的匹配的结束处继续，但不超过下一行的
开始处。如果没有此标志位，搜索从光标位置之后的一个字符
开始。使用 'c'，"abababababab" 重复用 "/abab" 模式时只
有三个匹配，没有 'c' 的话有五个。
*cpo-C*
C 不串接反斜杠开始的被 source 的行。见
|line-continuation|。
*cpo-d*
d 'tags' 选项使用 "./" 不意味着使用相对于当前文件的标签
文件，而是当前目录下的标签文件。
*cpo-D*
D 带有字符参数的普通模式命令不使用 CTRL-K 输入二合字母，
比如 |r|、|f| 和 |t|。
*cpo-e*
e 用 ":@r" 执行寄存器时，总是在最后一行加入 <CR>，即使寄
存器不是面向行的也如此。如果本标志位不存在、寄存器非面
向行且末行不以 <CR> 结尾的话，那么末行仍留在命令行上，
在按 <CR> 之前可以继续编辑。
*cpo-E*
E 在空区域上使用 "y"、"d"、"c"、"g~"、"gu" 或 "gU" 是个
错误。这些操作符至少需要操作一个字符。比如: "y0" 在第
一列会失败。
*cpo-f*
f 如果包含并且当前缓冲区还没有文件名，带文件名参数的
":read" 命令会为当前缓冲区设置文件名。
*cpo-F*
F 如果包含并且当前缓冲区还没有文件名，带文件名参数的
":write" 命令会为当前缓冲区设置文件名。另见 |cpo-P|。
*cpo-g*
g 没有参数的 ":edit" 会转到第一行。
*cpo-H*
H 如果在只有空白的行使用 "I"，在最后一个空白前插入。没有
此标志位，在最后一个空白后插入。
*cpo-i*
i 如果包含，读入时被中断的文件会使其状态成为已修改。
*cpo-I*
I 'autoindent' 插入缩进后上下移动光标不删除缩进。
*cpo-j*
j 连接行时，只有在 '.' 之后加入两个空格，'!' 或 '?' 之后
不会。另见 'joinspaces'。
*cpo-J*
J |sentence| 必须在 '.'，'!' 或 '?' 有两个空格才算。
<Tab> 不识别为空白。
*cpo-k*
k 映射、缩写和菜单命令的 "to" 部分不识别原始键盘代码。比
如，如果 <Key> 发送 ^[OA (其中的 ^[ 是 <Esc>)，命令
":map X ^[OA" 会使得 X 被映射为:
包含 'k' 时: "^[OA" (3 个字符)
排除 'k' 时: "<Key>" (单个键码)
另见下面的 '<' 标志位。
*cpo-K*
K 如果映射只完成键码的一部分，不等待其完成。这会使映射
<F1><F1> 在只读入第二个 <F1> 的一部分时无法工作。不
过，这意味着用 <F1><Esc> 就可以中止该映射。
*cpo-l*
l 搜索模式里的 [] 范围内的反斜杠按本义出现，只有 "\]"、
"\^"、"\-" 和 "\\" 是特别的。见 |/[]|
包含 'l' 时: "/[ \t]" 找到 <Space>、'\' 和 't'
排除 'l' 时: "/[ \t]" 找到 <Space> 和 <Tab>
另见 |cpo-\|。
*cpo-L*
L 如果置位 'list' 选项，'wrapmargin'、'textwidth'、
'softtabstop' 和虚拟替换模式 (见 |gR|) 把 <Tab> 看成两
个字符，和 <Tab> 的普通行为不同。
*cpo-m*
m 如果包含，showmatch 总会等到半秒。如果不包含，
showmatch 等待半秒或者到有字符输入为止。|'showmatch'|
*cpo-M*
M 如果排除，"%" 匹配会考虑反斜杠。所以 "( \( )" 和
"\( ( \)" 里，外层的括号会匹配。如果包含，"%" 忽略反斜
杠，这是 Vi 兼容行为。
*cpo-n*
n 如果包含，'number' 列也用于文本的回绕行。
*cpo-o*
o 不记住搜索命令的行偏移并将它用于下一个搜索。
*cpo-O*
O 如果文件被覆盖，即使开始编辑时该文件还不存在，也不会抱
怨。这项措施保护你不会意外地覆盖别人建立的文件。Vi 并
不会为此抱怨。
*cpo-p*
p Vi 兼容的 Lisp 缩进。如果不包含，使用稍好一些的算法。
*cpo-P*
P 如果包含，当当前缓冲区还没有文件名并且同时包含 'F' 标
志位 |cpo-F| 时，附加到文件后的 ":write" 命令会设置当
前缓冲区的文件名。
*cpo-q*
q 连接多行时，把光标留在连接两行时应该在的位置。
*cpo-r*
r 重复 ("." 命令) 使用 "/" 来重复搜索命令，而不一定使用
实际用过的搜索字符串。
*cpo-R*
R 删除过滤行的位置标记。没有该标志位，标记会被保存，就像
用了 |:keepmarks| 那样。
*cpo-s*
s 第一次进入缓冲区时，设置缓冲区选项。这和 Vim 3.0 版本
的行为相同，现在这也是缺省。如果不存在，选项在缓冲区建
立时设置。
*cpo-S*
S 每次进入缓冲区都设置缓冲区选项 (除了 'readonly'、
'fileformat'、'filetype' 和 'syntax' 以外)。这是 (最)
符合 Vi 兼容性的设定。
这些选项将被设为当前缓冲区的值。如果你改变选项并切换到
别的缓冲区，该值会被复制。这实际意味着，缓冲区选项全局
于所有缓冲区。
's' 'S' 缓冲区选项的复制在
否 否 建立缓冲区时
是 否 第一次进入缓冲区时 (缺省)
均可 是 每次进入缓冲区时 (vi 兼容)
*cpo-t*
t "n" 命令记住标签命令的搜索模式。否则，Vim 只把该模式
放到搜索模式的历史里，但不改变最近使用的搜索模式。
*cpo-u*
u 撤销的行为和 Vi 兼容。见 |undo-two-ways|。
*cpo-v*
v 插入模式里，退格删除的字符在屏幕上保持可见。没有本标志
位，该字符从屏幕上立即删除。有了本标志位，新输入的文本
覆盖屏幕上退格经过的字符。
*cpo-w*
w 在空白字符上使用 "cw" 只改变一个字符，而不是所有到下一
个单词之前的空白。
*cpo-W*
W 不覆盖只读文件。如果不提供，":w!" 在可能的情况下覆盖只
读文件。
*cpo-x*
x 命令行上输入 <Esc> 执行该命令行。
Vim 的缺省行为是放弃命令行。因为 <Esc> 通常的含义是中
止命令。|c_<Esc>|
*cpo-X*
X 使用计数时，"R" 只删除一次替换的文本。用带计数的 "."
来重复 "R" 也是如此。
*cpo-y*
y 抽出 (yank) 命令可以用 "." 重复。
*cpo-Z*
Z 置位 'readonly' 选项时，使用 "w!" 不复位 'readonly'。
*cpo-!*
! 重复过滤命令时，使用最后使用的外部命令，不管它是什么。
否则，使用最近的 -过滤- 命令。
*cpo-$*<