Vim documentation: term
*term.txt* For Vim version 8.0. 最近更新: 2017年8月
VIM 参考手册 by Bram Moolenaar
译者: Willis,tocer
http://vimcdoc.sf.net
终端信息 *terminal-info*
Vim 使用你使用的终端的信息来填充屏幕和识别你输入的键。如果信息不正确,屏幕可能
会混乱,而一些键也可能识别不了。屏幕上必须执行的动作是通过输出字符串完成的。特
殊键会产生一系列字符的序列。这些字符串存在终端选项里,见 |terminal-options|。
注意: 运行 |GUI| 的时候这里多数都用不到。
1. 启动 |startup-terminal|
2. 终端选项 |terminal-options|
3. 窗口大小 |window-size|
4. 慢速和快速终端 |slow-fast-terminal|
5. 使用鼠标 |mouse-using|
==============================================================================
1. 启动 *startup-terminal*
Vim 启动时,假定一个缺省终端类型。Amiga 上,这是一个标准的 CLI 窗口,MS-DOS 是
pc 终端,而 Unix 则是 ansi 终端。还有一些终端类型,它们都总是可用的,见下
|builtin-terms|。
使用 '-T' Vim 参数,你可以给出终端名。如果没有给出,Vim 会试图从 TERM 环境变量
里读取名字。
*termcap* *terminfo* *E557* *E558* *E559*
Unix 系统使用 terminfo 数据库或者 termcap 文件。在所有的文档里,这被统称为
"termcap"。编译时,configure 的运行会自动决定是用 terminfo 还是 termcap。如果
运行 Vim 时,":version" 的输出显示 |+terminfo| 的话,就意味着使用的是
terminfo。另见 |xterm-screens|。
在非 Unix 系统中,termcap 只有在 Vim 编译时定义 TERMCAP 才有效。
*builtin-terms* *builtin_terms*
内建的终端哪些可用,决定于 feature.h 的一些定义。这些需要在编译时确定:
定义 ":version" 的输出 内建的终端 ~
NO_BUILTIN_TCAPS -builtin_terms 无
SOME_BUILTIN_TCAPS +builtin_terms 大多数常用终端 (缺省)
ALL_BUILTIN_TCAPS ++builtin_terms 全部
用 ":set term=xxx" (在不运行 GUI 的时候)。你可以看到可用的内建终端类型列表。另
见 |+builtin_terms|。
如果包含了 termcap 的代码,Vim 会试图从 termcap 文件和内建的 termcap 里得到你
使用的终端的字符串。如果你使用的终端项目确实存在,两者都会使用。哪个在前面决定
于 'ttybuiltin' 选项的设置:
'ttybuiltin' 打开 1: 内建 termcap 2: 外部 termcap
'ttybuiltin' 关闭 1: 外部 termcap 2: 内建 termcap
如果其中某个选项不存在,就从另外一个那里读取。如果两个都存在,就从排名前面的那
个读取。
使用哪个外部 termcap 文件和不同的系统有关,也可能依赖于环境变量 "TERMCAP" 和
"TERMPATH"。见 "man tgetent"。
依赖于终端的设置 *term-dependent-settings*
如果你想根据终端名字设置选项或者映射,最好在 .vimrc 里设置。示例: >
if &term == "xterm"
... xterm 映射和设置 ...
elseif &term =~ "vt10."
... vt100、vt102 映射和设置 ...
endif
<
*raw-terminal-mode*
普通的编辑会把终端设为原始 ("raw") 模式。't_ti' 和 't_ks' 定义的字符串会送到终
端上。正常情况下,这把终端设为一个状态,该状态下能合法给出 termcap 代码,并激
活光标和功能键。Vim 退出终端时,它会回到 Vim 启动前的模式。't_te' 和 't_ke' 定
义的字符串会发送给终端。在 Amiga 上,执行外部命令的命令 (例如 "!!") 会把终端暂
时置回普通模式。这意味着你可以按打印键停止到屏幕的输出。输出在按 <BS> 时继续。
*xterm-bracketed-paste*
如果设置了 't_BE' 选项,进入 "raw" 模式时会发送 't_BE' 到终端,退出 "raw" 模式
时则发送 't_BD'。终端应在粘贴文本之前发送 't_PS',而粘贴文本之后发送 't_PE'。
这样 Vim 就能区隔粘贴的文本和键入的字符。粘贴文本的处理就像使用了鼠标中键,按
本义插入而不作命令解释。
光标在首列时,在光标前插入粘贴文本。否则在光标位置之后附加粘贴文本。这意味着你
不能在首列之后粘贴。不幸的是 Vim 没有办法知道鼠标指针在哪里。
注意 有些情况下 Vim 不能识别这种括号内的粘贴,而只能得到原始的文本。在其它一些
情况下,Vim 只能得到首个粘贴的字符而丢失其余的部分,例如在使用 "r" 命令时。如
果你对此不满意,在 .vimrc 这样关闭带括号的粘贴: >
set t_BE=
如果这样做,Vim 运行时发送 't_BD' 给终端以关闭括号内的粘贴。
*cs7-problem*
注意: 如果终端设置在运行 Vim 以后改变,你可能会碰到不合法的设置组合。有报告说
Solaris 2.5 上 "stty cs8 parenb",使用 "stty cs7 parenb" 恢复就会有这个问题。
如果你使用 "stty cs8 -parenb -istrip",就能正确恢复了。
有些 termcap 项目在某种意义上是错误的,因为发送 't_ks' 后光标键发送的代码和
termcap 定义的不同。要避免这一点,你需要设置 't_ks' (和 't_ke') 为空值。这必须
在初始化时进行 (见 |initialization|),不然就太晚了。
有些终端项目假设最高位总是被复位的。例如: Amiga 上光标向上项目可以是
":ku=\E[A:"。但是 Amiga 实际发送 "\233A"。如果最高位被复位,这没有问题,比如在
串行线使用 Amiga 的时候。如果光标键不工作,尝试一下项目 ":ku=\233A:"。
有些 termcap 项目使用 ":ku=\E[A:"。但 Amiga 实际发送 "\233A"。输出结果 "\E["
和 "\233" 经常是等价的,但输入时则不然。要修正这一问题,你需要修改 termcap 项
目,或者用 :set 命令改变键码 (译者注: 这段内容有重复,但原文如此)。
许多光标键以单个 <Esc> 开始。Vim 必须找出是否这确实是 <Esc> 键单击,还是光标键
序列的开始。它等待下一个字符到达。如果一秒钟不出现,就假设是单个 <Esc>。在很慢
的系统里,这可能失败,使得有时候光标键不能工作。如果你发现这一问题,复位
'timeout' 选项。Vim 会在 <Esc> 之后等待下一个字符的来临。如果你需要输入单个
<Esc>,必须输入两次。复位 'esckeys' 选项在插入模式下避免这个问题,但是这样你不
能在插入模式下使用光标和功能键。
Amiga 上窗口调整大小的识别只有在终端名为 "amiga" 或 "builtin_amiga" 才有可能。
有些终端的光标键的代码不明确。televideo 925 就是这样的一个终端。光标左键发送的
是 CTRL-H。这使得退格和光标左键无法区别。要避免这一问题,CTRL-H 永远不会识别为
光标左键。
*vt100-cursor-keys* *xterm-cursor-keys*
其它终端 (例如,vt100 和 xterm) 的光标键发送 <Esc>OA、<Esc>OB,等等。不幸的
是,这些是插入模式下合法的命令: 结束插入,在上面打开新行,开始插入 'A'、'B',
等等。Vim 不会执行这些命令,相反,它会把该输入键序列识别为光标键的移动。要避免
这一点而使 Vim 在两种情况下都能工作,你需要以下设置: >
:set notimeout " 映射时不检查超时
:set ttimeout " 终端键码检查超时
:set timeoutlen=100 " 超时为 100 毫秒
这要求键码在 100 毫秒的间隔内发送,从而能识别其为光标键。正常情况下,你的输入
不会那么快,所以它们能被识别为单独输入的命令,即使 Vim 收到了相同的字节序列。
*vt100-function-keys* *xterm-function-keys*
xterm 可以用两种模式发送功能键 F1 到 F4: vt100 兼容模式或不兼容模式。因为 Vim
可能不知道 xterm 发送的是哪种,两种都被识别。<Home> 和 <End> 键情况相同。
普通 vt100 ~
<F1> t_k1 <Esc>[11~ <xF1> <Esc>OP *<xF1>-xterm*
<F2> t_k2 <Esc>[12~ <xF2> <Esc>OQ *<xF2>-xterm*
<F3> t_k3 <Esc>[13~ <xF3> <Esc>OR *<xF3>-xterm*
<F4> t_k4 <Esc>[14~ <xF4> <Esc>OS *<xF4>-xterm*
<Home> t_kh <Esc>[7~ <xHome> <Esc>OH *<xHome>-xterm*
<End> t_@7 <Esc>[4~ <xEnd> <Esc>OF *<xEnd>-xterm*
Vim 启动时,<xF1> 被映射到 <F1>,<xF2> 到 <F2> 等等。这意味着缺省两种代码做相
同的事情。如果你为 <xF2> 定义了映射而你的终端支持两种键,那么就覆盖了缺省的映
射,从而可以用 <F2> 和 <xF2> 键做不同的事情。
*xterm-shifted-keys*
更新的 xterm 版本支持 Shift + 功能键和特殊键。Vim 识别其中的大多数。使用 ":set
termcap" 来检查哪些是支持的,相应的代码为何。多数情况下这些不在 termcap 里,只
有 builtin_xterm termcap 才支持。
*xterm-modifier-keys*
新版 xterm 对于大多数功能键支持 Alt 和 Ctrl。为避免增加 Alt、Ctrl 和 Shift 对
每个键的捆绑,在 termcap 项目末尾识别一个特殊序列: ";*X"。"X" 可以是任何字符,
通常是 '~'。";*" 支持一个可选的修饰符参数。";2" 代表 Shift,";3" 是 Alt,";5"
是 Ctrl,";9" 是 Meta (当它与 Alt 不同时)。它们可以组合使用。例如: >
:set <F8>=^[[19;*~
:set <Home>=^[[1;*H
关于这些代码的另一个特性是它们不能被另外的代码覆盖。这就避免了被来自 xterm
|t_RV| 所包含的代码直接覆盖掉。
*xterm-scroll-region*
Sun 和其它的平台上的 xterm 缺省的 termcap 项目不包含区域滚动的项目。在
/etc/termpcap 的 xterm 项目里增加 ":cs=\E[%i%d;%dr:",那么一切都没有问题了。
*xterm-end-home-keys*
在一些系统上 (至少使用 XFree86 3.1.2 的 FreeBSD),<End> 和 <Home> 键的代码里包
含 <Nul> 字符。要使得这些键发送正确的键码,在你的 ~/.Xdefaults 文件里增加:
*VT100.Translations: #override \n\
<Key>Home: string("0x1b") string("[7~") \n\
<Key>End: string("0x1b") string("[8~")
*xterm-8bit* *xterm-8-bit*
Xterm 可以在使用 8 位转义序列的模式里运行。这里,CSI 代码代替了 <Esc>[。它的优
点是,<Esc> 键可以在插入模式下更快的识别,因为不会和特殊键的开始相混淆。
对于内建的 termcap 项目而言,Vim 检查 'term' 选项是否包含 "8bit"。如果是,就在
termcap 项目、鼠标和一些其它的项目中使用 8 位字符,通常,你在外壳里设置 $TERM
为 "xterm-8bit"。Vim 会发现这一点,并自动调整 8 位设置。
如果 Vim 接收到对 |t_RV| 序列的应答 (请求版本) 并且它以 CSI 开始,就假设终端处
于 8 位模式,并把所有的健序列转换为它们的 8 位版本。
==============================================================================
2. 终端选项 *terminal-options* *termcap-options* *E436*
终端选项可以和普通选项一样设置。但不会在 ":set all" 命令里显示。相反,应该用
":set termcap"。
通过设置合适的选项,你总是可以调整个别字符串的值。例如: >
:set t_ce=^V^[[K (CTRL-V,<Esc>,[,K)
{Vi: 没有终端选项。你必须退出 Vi,修改 termcap 项,并重新打开}
这些选项列在下面。相关的 termcap 代码总是等价于选项名字的最后两个字符。只有一
个 termcap 代码是必须的: 光标移动,'t_cm'。
选项 't_da'、't_db'、't_ms'、't_xs'、't_xn' 代表 termcap 里的标志位。termcap
标志位存在时,选项总是设为 "y"。但是任何非空的字符串意味着标志位已经置位。而空
字符串代表该标志位没有置位。't_CS' 也是这样的,虽然它不是 termcap 的标志位。
输 出 代 码 *terminal-output-codes*
选项 含义 ~
t_AB 设置背景色 (ANSI) *t_AB* *'t_AB'*
t_AF 设置前景色 (ANSI) *t_AF* *'t_AF'*
t_AL 增加若干空行 *t_AL* *'t_AL'*
t_al 增加一行空行 *t_al* *'t_al'*
t_bc 退格字符 *t_bc* *'t_bc'*
t_cd 清除到屏幕尾 *t_cd* *'t_cd'*
t_ce 清除到行尾 *t_ce* *'t_ce'*
t_cl 清除屏幕 *t_cl* *'t_cl'*
t_cm 光标移动 (必需!) *E437* *t_cm* *'t_cm'*
t_Co 颜色数目 *t_Co* *'t_Co'*
t_CS 如果非空,光标相对于滚动区域 *t_CS* *'t_CS'*
t_cs 定义滚动区域 *t_cs* *'t_cs'*
t_CV 定义垂直滚动区域 *t_CV* *'t_CV'*
t_da 如果非空,上方的行可以向下滚动 *t_da* *'t_da'*
t_db 如果非空,下方的行可以向上滚动 *t_db* *'t_db'*
t_DL 删除若干行 *t_DL* *'t_DL'*
t_dl 删除一行 *t_dl* *'t_dl'*
t_fs 结束设置窗口标题 (退出 termcap 状态行) *t_fs* *'t_fs'*
t_ke 结束 "keypad 传输" 模式 *t_ke* *'t_ke'*
t_ks 进入 "keypad 传输" 模式 *t_ks* *'t_ks'*
t_le 左移光标一个字符 *t_le* *'t_le'*
t_mb 闪烁模式 *t_mb* *'t_mb'*
t_md 加粗模式 *t_md* *'t_md'*
t_me 普通模式 (撤销 t_mr、t_mb、t_md 和颜色) *t_me* *'t_me'*
t_mr 反转模式 *t_mr* *'t_mr'*
t_ms 如果非空,光标可以在突出/反转模式下移动 *t_ms* *'t_ms'*
t_nd 非破坏性的空格字符 *t_nd* *'t_nd'*
t_op 复位到原先的颜色对 *t_op* *'t_op'*
t_RI 光标右移若干字符 *t_RI* *'t_RI'*
t_Sb 设置背景色 *t_Sb* *'t_Sb'*
t_Sf 设置前景色 *t_Sf* *'t_Sf'*
t_se 结束突出 *t_se* *'t_se'*
t_so 退出模式 *t_so* *'t_so'*
t_sr 反向滚动 (往下) *t_sr* *'t_sr'*
t_te 退出 "termcap" 模式 *t_te* *'t_te'*
t_ti 让终端进入 "termcap" 模式 *t_ti* *'t_ti'*
t_ts 开始设置窗口标题 (进入 termcap 状态行) *t_ts* *'t_ts'*
t_ue 下划结束 *t_ue* *'t_ue'*
t_us 下划模式 *t_us* *'t_us'*
t_Ce 下曲 (undercurl) 结束 *t_Ce* *'t_Ce'*
t_Cs 下曲模式 *t_Cs* *'t_Cs'*
t_ut 使用当前背景色清除 *t_ut* *'t_ut'*
t_vb 可视铃声 *t_vb* *'t_vb'*
t_ve 光标可见 *t_ve* *'t_ve'*
t_vi 光标不可见 *t_vi* *'t_vi'*
t_vs 光标 "非常" 可见 *t_vs* *'t_vs'*
t_xs 如果非空,突出部分不能通过覆盖删除 (hpterm) *t_xs* *'t_xs'*
t_xn 如果非空,在屏幕最后单元里写入字符不导致滚动 *t_xn* *'t_xn'*
t_ZH 斜体模式 *t_ZH* *'t_ZH'*
t_ZR 斜体结束 *t_ZR* *'t_ZR'*
Vim 增加的 (它们没有标准代码):
t_IS 开始设置图标文本 *t_IS* *'t_IS'*
t_IE 结束设置图标文本 *t_IE* *'t_IE'*
t_WP 设置窗口位置 (Y,X),以像素计算 *t_WP* *'t_WP'*
t_GP 获取窗口位置 (Y,X),以像素计算 *t_GP* *'t_GP'*
t_WS 设置窗口大小 (高度,宽度) 以字符数计算 *t_WS* *'t_WS'*
t_SI 开始插入模式 (条形光标) *t_SI* *'t_SI'*
t_SR 开始替换模式 (下划线光标) *t_SR* *'t_SR'*
t_EI 结束插入或替换模式 (块形光标) *t_EI* *'t_EI'*
|termcap-cursor-shape|
t_RV 请求终端版本字符串 (适用于 xterm) *t_RV* *'t_RV'*
|xterm-8bit| |v:termresponse| |'ttymouse'| |xterm-codes|
t_u7 请求光标位置 (适用于 xterm) *t_u7* *'t_u7'*
见 |'ambiwidth'|
t_RB 请求终端背景色 *t_RB* *'t_RB'*
t_8f 设置终端前景色 (R, G, B) *t_8f* *'t_8f'*
|xterm-true-color|
t_8b 设置终端背景色 (R, G, B) *t_8b* *'t_8b'*
|xterm-true-color|
t_BE 打开括号内粘贴模式 *t_BE* *'t_BE'*
|xterm-bracketed-paste|
t_BD 关闭括号内粘贴模式 *t_BD* *'t_BD'*
|xterm-bracketed-paste|
键 代 码 *terminal-key-codes*
备注: 尽量使用 <> 形式
选项 名字 含义 ~
t_ku <Up> 光标上移 *t_ku* *'t_ku'*
t_kd <Down> 光标下移 *t_kd* *'t_kd'*
t_kr <Right> 光标右移 *t_kr* *'t_kr'*
t_kl <Left> 光标左移 *t_kl* *'t_kl'*
<xUp> 替代的光标上移 *<xUp>*
<xDown> 替代的光标下移 *<xDown>*
<xRight> 替代的光标右移 *<xRight>*
<xLeft> 替代的光标左移 *<xLeft>*
<S-Up> shift 光标上移
<S-Down> shift 光标下移
t_%i <S-Right> shift 光标右移 *t_%i* *'t_%i'*
t_#4 <S-Left> shift 光标左移 *t_#4* *'t_#4'*
t_k1 <F1> 功能键 1 *t_k1* *'t_k1'*
<xF1> 替代的 F1 *<xF1>*
t_k2 <F2> 功能键 2 *<F2>* *t_k2* *'t_k2'*
<xF2> 替代的 F2 *<xF2>*
t_k3 <F3> 功能键 3 *<F3>* *t_k3* *'t_k3'*
<xF3> 替代的 F3 *<xF3>*
t_k4 <F4> 功能键 4 *<F4>* *t_k4* *'t_k4'*
<xF4> 替代的 F4 *<xF4>*
t_k5 <F5> 功能键 5 *<F5>* *t_k5* *'t_k5'*
t_k6 <F6> 功能键 6 *<F6>* *t_k6* *'t_k6'*
t_k7 <F7> 功能键 7 *<F7>* *t_k7* *'t_k7'*
t_k8 <F8> 功能键 8 *<F8>* *t_k8* *'t_k8'*
t_k9 <F9> 功能键 9 *<F9>* *t_k9* *'t_k9'*
t_k; <F10> 功能键 10 *<F10>* *t_k;* *'t_k;'*
t_F1 <F11> 功能键 11 *<F11>* *t_F1* *'t_F1'*
t_F2 <F12> 功能键 12 *<F12>* *t_F2* *'t_F2'*
t_F3 <F13> 功能键 13 *<F13>* *t_F3* *'t_F3'*
t_F4 <F14> 功能键 14 *<F14>* *t_F4* *'t_F4'*
t_F5 <F15> 功能键 15 *<F15>* *t_F5* *'t_F5'*
t_F6 <F16> 功能键 16 *<F16>* *t_F6* *'t_F6'*
t_F7 <F17> 功能键 17 *<F17>* *t_F7* *'t_F7'*
t_F8 <F18> 功能键 18 *<F18>* *t_F8* *'t_F8'*
t_F9 <F19> 功能键 19 *<F19>* *t_F9* *'t_F9'*
<S-F1> shift 功能键 1
<S-xF1> 替代的 <S-F1> *<S-xF1>*
<S-F2> shift 功能键 2 *<S-F2>*
<S-xF2> 替代的 <S-F2> *<S-xF2>*
<S-F3> shift 功能键 3 *<S-F3>*
<S-xF3> 替代的 <S-F3> *<S-xF3>*
<S-F4> shift 功能键 4 *<S-F4>*
<S-xF4> 替代的 <S-F4> *<S-xF4>*
<S-F5> shift 功能键 5 *<S-F5>*
<S-F6> shift 功能键 6 *<S-F6>*
<S-F7> shift 功能键 7 *<S-F7>*
<S-F8> shift 功能键 8 *<S-F8>*
<S-F9> shift 功能键 9 *<S-F9>*
<S-F10> shift 功能键 10 *<S-F10>*
<S-F11> shift 功能键 11 *<S-F11>*
<S-F12> shift 功能键 12 *<S-F12>*
t_%1 <Help> 帮助键 *t_%1* *'t_%1'*
t_&8 <Undo> 撤销键 *t_&8* *'t_&8'*
t_kI <Insert> 插入键 *t_kI* *'t_kI'*
t_kD <Del> 删除键 *t_kD* *'t_kD'*
t_kb <BS> 退格键 *t_kb* *'t_kb'*
t_kB <S-Tab> 反制表 (shift-tab) *<S-Tab>* *t_kB* *'t_kB'*
t_kh <Home> home 键 *t_kh* *'t_kh'*
t_#2 <S-Home> shift home 键 *<S-Home>* *t_#2* *'t_#2'*
<xHome> 替代的 home 键 *<xHome>*
t_@7 <End> end 键 *t_@7* *'t_@7'*
t_*7 <S-End> shift end 键 *<S-End>* *t_star7* *'t_star7'*
<xEnd> 替代的 end 键 *<xEnd>*
t_kP <PageUp> page-up 键 *t_kP* *'t_kP'*
t_kN <PageDown> page-down 键 *t_kN* *'t_kN'*
t_K1 <kHome> keypad home 键 *t_K1* *'t_K1'*
t_K4 <kEnd> keypad end 键 *t_K4* *'t_K4'*
t_K3 <kPageUp> keypad page-up 键 *t_K3* *'t_K3'*
t_K5 <kPageDown> keypad page-down 键 *t_K5* *'t_K5'*
t_K6 <kPlus> keypad 加号键 *<kPlus>* *t_K6* *'t_K6'*
t_K7 <kMinus> keypad 减号键 *<kMinus>* *t_K7* *'t_K7'*
t_K8 <kDivide> keypad 除号 *<kDivide>* *t_K8* *'t_K8'*
t_K9 <kMultiply> keypad 乘号 *<kMultiply>* *t_K9* *'t_K9'*
t_KA <kEnter> keypad 回车键 *<kEnter>* *t_KA* *'t_KA'*
t_KB <kPoint> keypad 小数点 *<kPoint>* *t_KB* *'t_KB'*
t_KC <k0> keypad 0 *<k0>* *t_KC* *'t_KC'*
t_KD <k1> keypad 1 *<k1>* *t_KD* *'t_KD'*
t_KE <k2> keypad 2 *<k2>* *t_KE* *'t_KE'*
t_KF <k3> keypad 3 *<k3>* *t_KF* *'t_KF'*
t_KG <k4> keypad 4 *<k4>* *t_KG* *'t_KG'*
t_KH <k5> keypad 5 *<k5>* *t_KH* *'t_KH'*
t_KI <k6> keypad 6 *<k6>* *t_KI* *'t_KI'*
t_KJ <k7> keypad 7 *<k7>* *t_KJ* *'t_KJ'*
t_KK <k8> keypad 8 *<k8>* *t_KK* *'t_KK'*
t_KL <k9> keypad 9 *<k9>* *t_KL* *'t_KL'*
<Mouse> 鼠标代码的引导键 *<Mouse>*
t_PS 括号内粘贴的开始 |xterm-bracketed-paste| *t_PS* *'t_PS'*
t_PE 括号内粘贴的结束 |xterm-bracketed-paste| *t_PE* *'t_PE'*
关于 t_so 和 t_mr 的 注意 事项: 如果 termcap 项目 "so" 不存在,则使用 "mr" 的
项目。反之亦然。"se" 和 "me" 也是一样。如果你的终端同时支持反转和突出模式,你
可以看到两种不同的模式。如果只支持其中一种,则两者看起来一样。
*keypad-comma*
keypad 键在没有映射时和等价的普通键等价。但有一个特例: 如果你的 keypad 有逗号
而不是小数点,Vim 仍然认为那是小数点。下面的映射可以修正这个问题: >
:noremap <kPoint> ,
:noremap! <kPoint> ,
< *xterm-codes*
得到键码有一个特殊的技巧,现在这只适用于 xterm。如果定义了 |t_RV|,而且得到的
响应指示使用的版本是补丁级别不低于 141 的 xterm,Vim 就使用特殊的转义序列来从
xterm 里直接取得键码。响应的内容用于调整各种 t_ 代码。这样,xterm 可能根据所处
的模式 (8-位、VT102、VT220,等等) 产生不同代码的问题就避免了。结果是,<xF1> 这
样的代码就不需要了。
注意: 这只能在启动时完成。如果 xterm 选项在 Vim 启动以后被改变,这些转义序列就
不再能识别了。
*xterm-true-color*
只要终端支持,Vim 支持终端真彩 (使用 |highlight-guifg| 和 |highlight-guibg|)。
为此,置位 'termguicolors' 选项。
https://gist.github.com/XVilka/8346728 有支持真彩的终端列表。
有时置位 'termguicolors' 还不够,还需要显式设置 |t_8f| 和 |t_8b| 选项。这些选
项的缺省值分别是 "^[[38;2;%lu;%lu;%lum" 和 "^[[48;2;%lu;%lu;%lum",但只当
`$TERM` 为 `xterm` 时才设置。有些终端也接受相同的序列,但把所有的分号替换为冒
号 (这样实际更兼容,但支持不是那么广泛): >
let &t_8f = "\<Esc>[38:2:%lu:%lu:%lum"
let &t_8b = "\<Esc>[48:2:%lu:%lu:%lum"
这些选项包含 printf 字符串,调用 |printf()| (实际上,它的 C 等价函数,因此带有
`l` 修饰符) 时带上 t_ 选项值和三个无符号长整数,分别代表红、绿和蓝色的 0 到
255 (包含) 之间的任意值。
*xterm-resize*
xterm 改变窗口大小的功能只用在 allowWindowOps 资源打开时才可用。有些系统或有些
版本的 xterm 缺省该值是关闭的,因为有安全上的考虑。我们不肯定是否真有此必要。
要覆盖缺省值,在 ~/.Xdefaults 或 ~/.Xresources 中放入:
>
XTerm*allowWindowOps: true
然后运行 "xrdb -merge .Xresources" 以激活之。用上下文菜单可以检查该值 (按住
CTRL 键的同时按鼠标右键),在 allow-window-ops 边上应该打了勾。
*termcap-colors*
关于颜色的 注意 事项: 't_Co' 选项告诉 Vim 可用的颜色数。如果非零,'t_AB' 和
't_AF' 选项可以用来设置颜色。如果这些都不可用,就使用 't_Sb' 和 't_Sf'。't_me'
用来复位到缺省的颜色设置。
*termcap-cursor-shape* *termcap-cursor-color*
Vim 进入插入模式时,发送 't_SI' 转义序列。Vim 进入替换模式而 't_SR' 已设置时,
发送 't_SR' 转义序列,否则发送 't_SI'。当离开插入或替换模式时,发送 't_EI'。
这可以用来改变插入模式下光标的形状或颜色。它们不是标准的 termcap/terminfo 项
目,你需要自己设定。
一个 xterm 的例子,改变光标颜色: >
if &term =~ "xterm"
let &t_SI = "\<Esc>]12;purple\x7"
let &t_SR = "\<Esc>]12;red\x7"
let &t_EI = "\<Esc>]12;blue\x7"
endif
<
注意: 当 Vim 退出时,将保留普通模式的光标形状,而不会恢复 Vim 启动之前的形状。
{仅当编译时加入 |+cursorshape| 特性才支持}
*termcap-title*
如果终端允许通过发送字符串设置标题的话,'t_ts' 和 't_fs' 选项用来设置窗口的标
题。在发送标题字符串之前和之后分别发送两者。类似的,'t_IS' 和 't_IE' 用来设置
图标文本。这些是 Vim 内部对 Unix termcap 的扩展,所以它们的值不能从外部
termcap 获取。不过,内建的 termcap 包含 xterm 和 iris-ansi 的合适的项目,所以
你不需要在这里设置。
*hpterm*
如果反转和其他高亮方式不工作,尝试设置 't_xs' 选项为非空字符串。这使得 't_ce'
代码可以用于从行里撤销高亮。对 "hpterm" 这是必需的。置位 'weiredinvert' 选项和
设置 't_xs' 非空的相同的效果,反之亦然。
*scroll-region*
有些 termcap 不包括 'cs' (滚动区域) 的项目,尽管有些终端支持这一特性。比如,
Sun 上的 xterm。你可以使用内建的 builtin_xterm 或者自己定义 t_cs。例如: >
:set t_cs=^V^[[%i%d;%dr
其中 ^V 是 CTRL-V,而 ^[ 是 <Esc>。
垂直滚动区域 t_CV 不是标准的 termcap 代码。Vim 在 GUI 里内部使用之。但是如果你
能找到支持这一特性的终端,也可以在终端里定义,两个参数分别是限制滚动的区域的左
边列和右边列。就像 t_cs 定义顶部行和底部行那样。定义 t_CV 会使得在垂直分割的窗
口里滚动窗口快很多。如果 t_da 或者 t_db 设置了,不要设置 t_CV (文本在滚动时不
会清除)。
不幸的是无法从 termcap 里推断光标定位应不应该使用滚动区域: 是相对于屏幕的开始
处,还是相对于滚动区域的开始处。大多数终端使用第一种方法。已知的一个例外是
MS-DOS 的终端 (pcterm)。在光标定位相对于滚动区域的情况下,'t_CS' 选项应该设置
为任何非空字符串。反之,则设为空字符串。在 'term' 为 "pcterm" 时,它缺省为
"yes"。
xterm 用户 注意: shift + 光标键一般不工作。要使用 xmodmap 命令和 Vim 里的一些
设置才可以。
在 xterm 里给出如下命令:
xmodmap -e "keysym Up = Up F13"
xmodmap -e "keysym Down = Down F16"
xmodmap -e "keysym Left = Left F18"
xmodmap -e "keysym Right = Right F19"
然后在 Vim 里使用这些映射:
:map <t_F3> <S-Up>
:map! <t_F3> <S-Up>
:map <t_F6> <S-Down>
:map! <t_F6> <S-Down>
:map <t_F8> <S-Left>
:map! <t_F8> <S-Left>
:map <t_F9> <S-Right>
:map! <t_F9> <S-Right>
与其使用,比如说, <S-Up>,你可以使用任何其它的命令来做你希望 shift + 光标上移
做的事情。(注意: 为了帮助使用有左侧键的 Sun 键盘的人,不要使用 F14,因为它和撤
销键有冲突;不要用 F15,因为它执行把窗口转到前台的操作;也不要用 F17,因为它关
闭窗口。其他系统上,你也许可以用这些键。)
==============================================================================
3. 窗口大小 *window-size*
[这是关于 Vim 使用的整个窗口,不是用 ":split" 命令创建的那种窗口。(译者注: Vim
里的术语或者用屏幕更合适些。)]
如果你在 Amiga 上运行 Vim,而终端名是 "amiga" 或 "builtin_amiga",打开 amiga
专用的窗口大小调整技术。Unix 系统上,有三个方法可以得到窗口的大小:
- ioctl 调用 (TIOCGSIZE 或者 TIOCGWINSZ,视乎你的系统而定)
- 环境变量 "LINES" 和 "COLUMNS"
- termcap 项目 "li" 和 "co"
如果所有这些都不行,假设缺省大小为 24 行和 80 列。如果收到改变窗口大小的信号,
大小会重新设置。如果窗口大小不正确,你可以用 'lines' 和 'columns' 选项来设置正
确的值。
这个命令可以设置屏幕大小:
*:mod* *:mode* *E359*
:mod[e] [mode]
如果不带参数,该命令检测屏幕大小并重画屏幕。在 MS-DOS 上,可以切换屏幕模式。
[mode] 可以是取以下的值:
"bw40" 40 列黑白
"c40" 40 列彩色
"bw80" 80 列黑白
"c80" 80 列彩色 (大多数人用这个)
"mono" 80 列单色
"c4350" 43 或者 50 行 EGA/VGA 模式
number 使用模式号,取决于你的显示卡
==============================================================================
4. 慢速和快速终端 *slow-fast-terminal*
*slow-terminal*
如果你有一个快速终端,你可能愿意置位 'ruler' 选项。光标位置将显示在状态行上。
如果你使用横向滚动 (关闭 'wrap' 选项),考虑把 'sidescroll' 设小一点。
如果你有一个慢速终端,你也许希望复位 'showcmd' 选项。这样,命令字符就不会显示
在状态行上。如果终端滚动很慢,把 'scrolljump' 设为 5 左右。如果光标离开屏幕
(例如,用 "j"),Vim 会一次滚动 5 行。另外一个可能性是减少 Vim 使用的行数,通过
"z{height}<CR>" 命令。
如果终端的字符到达时间相距超过 1 秒,你也许希望设置 'timeout' 和/或 'ttimeout'
选项。见 "Options" 一章 |options|。
如果你的终端不支持滚动区域,但是支持插入/删除行命令,多个窗口的滚动也许会使得
行跳上跳下。如果你不希望这样,置位 'ttyfast' 选项,它使得窗口重画,而不是行滚
动。
如果你的终端滚动很慢,但是重画却不慢,把 'ttyscroll' 设小一点,比如 3。这使得
Vim 在超过 3 行需要滚动时,重画屏幕而不是滚动。
如果你使用一个慢速的彩色终端,使用命令: >
hi NonText cterm=NONE ctermfg=NONE
这避免了空格在改变属性时被重复发送。大多数终端上,你反正也不会看到任何区别。
如果你在慢速的串行线上使用 Vim,你也许想要尝试在 "screen" 程序里运行 Vim。
screen 优化终端 I/O 挺不错的。
如果你在测试 termcap 选项,但是你看不到发生了什么,你也许希望设置 'writedelay'
选项。如果非零,每次给终端只发一个字符 (MS-DOS 上不行)。这使得屏幕刷新变慢很
多,从而能看清楚发生了什么。
==============================================================================
5. 使用鼠标 *mouse-using*
本节说明在终端或者终端窗口里如何使用鼠标。GUI 窗口里如何使用鼠标在 |gui-mouse|
里解释。关于使用鼠标滚轮进行滚动的部分见 |scroll-mouse-wheel|。
不要忘记用以下命令打开鼠标: >
:set mouse=a
否则 Vim 不会在所有模式下识别鼠标 (见 'mouse')。
目前,鼠标只有在 Unix 的 xterm 窗口、带 |sysmouse| 的 *BSD 控制台、Linux 终端
(带 GPM |gpm-mouse|)、MS-DOS 和 Windows 终端上才支持。鼠标键击可以用来定位光
标,设置区域并粘贴。
'mouse' 选项的字符决定 Vim 在什么场合下会使用鼠标:
n 普通模式
v 可视模式
i 插入模式
c 命令行模式
h 在帮助文件里,以上所有的模式
a 以上所有的模式
r 跳过 |hit-enter| 提示
'mouse' 的缺省值为空,即不使用鼠标。通常你会用: >
:set mouse=a
来开始使用鼠标 (这等价于设置 'mouse' 为 "nvich")。如果你只想在若干模式下或者在
某两个任务上使用鼠标,你需要专注于那些模式对应的字母。例如: >
:set mouse=nv
会使得鼠标在普通模式和可视模式下工作。 >
:set mouse=h
会使得鼠标只有在帮助文件里工作 (这样,可以用 "g<LeftMouse>" 来进行标签跳转)。
鼠标能否在可视模式或者选择模式下开始选择,决定于 "selectmode" 选项包不包括
"mouse"。
在 xterm 终端里,在 'mouse' 选项包含当前激活的模式的前提下,普通的鼠标键击归
Vim 使用,而带 shift 或者 ctrl 键的鼠标键击由 xterm 控制。如果 'mouse' 不包括
当前激活的模式,则所有的鼠标键击由 xterm 控制。
*xterm-clipboard*
Athena 和 Motif GUI 版本上,如果在终端运行但是可以访问 X-server (设置了
DISPLAY),那么复制和粘贴和 GUI 上的行为相似。如果不是,那么鼠标中键会插入无名
寄存器。这种情况下,这里是如何复制和粘贴一段文本的方法:
用鼠标和可视模式复制/粘贴 ('mouse' 选项必须设置,见上):
1. 在文本的第一个字符上按鼠标左键,移动鼠标到文本的最后一个字母,然后释放左
键。这会启动可视模式并高亮选择区域。
2. 按 "y" 抽出可视文本到无名寄存器里。
3. 在要插入的位置上按鼠标左键。
4. 按鼠标中键。
快捷方式: 如果插入位置和可视文本同时出现在屏幕上,你可以一次做 2、3 和 4: 在要
插入的位置直接按鼠标中键。
注意: 如果使用 |-X| 命令行参数,Vim 不会连接到 X 服务器,所以复制/粘贴到 X 剪
贴板 (选择区) 不会工作。使用带 shift 键的鼠标键来让 xterm 完成选择。
*xterm-command-server*
如果 X-服务器的剪贴板可用,|x11-clientserver| 的命令服务器可以在命令行用
--servername 打开。
*xterm-copy-paste*
注意: 在有些 (较老的) xterm 版本里,光标不能移动超过第 95 或 223 列。这是
xterm 的问题,不是 Vim 的。用新一点的 xterm 吧 |color-xterm|。另见
'ttymouse'。
使用 xterm 粘贴/复制 (当前模式_不_包括在 'mouse' 里):
1. 在文本的第一个字符上按鼠标左键,移动鼠标到文本的最后一个字母,然后释放。
2. 使用普通的 Vim 命令把光标移动到待插入的位置。
3. 按 "a" 开始插入模式。
4. 按鼠标中键。
5. 按 ESC 退出插入模式。
(对包含在 'mouse' 里的模式,这里的操作同样可以完成,只要你在使用鼠标的时候按住
shift 键就行了。)
注意: 如果你在粘贴的时候丢失了第 8 位 (特殊字符被翻译成其他字符),你需要在启动
Vim 之前在外壳上执行 "stty cs8 -istrip -parenb"。
这样,在 xterm 上 shift 和 ctrl 键不能和鼠标一起使用。需要 CTRL 修饰符的鼠标命
令可以在使用鼠标前按 "g" 键模拟:
"g<LeftMouse>" 是 "<C-LeftMouse> (跳转到鼠标点击的标签上)
"g<RightMouse>" 是 "<C-RightMouse> ("CTRL-T")
*mouse-mode-table* *mouse-overview*
如果 'mousemodel' 是 "extend" ,鼠标按钮的功能的概述在此:
普通模式:
事件 移动光标 选择 改变窗口 行动 ~
<LeftMouse> 是 结束 是
<C-LeftMouse> 是 结束 是 "CTRL-]" (2)
<S-LeftMouse> 是 不改变 是 "*" (2) *<S-LeftMouse>*
<LeftDrag> 是 开始或者扩展 (1) 否 *<LeftDrag>*
<LeftRelease> 是 开始或者扩展 (1) 否
<MiddleMouse> 是 如果没有激活 否 放置
<MiddleMouse> 是 如果激活 否 抽出和放置
<RightMouse> 是 开始或者扩展 是
<A-RightMouse> 是 开始或者扩展列块 是 *<A-RightMouse>*
<S-RightMouse> 是 不改变 是 "#" (2) *<S-RightMouse>*
<C-RightMouse> 否 不改变 否 "CTRL-T"
<RightDrag> 是 扩展 否 *<RightDrag>*
<RightRelease> 是 扩展 否 *<RightRelease>*
插入或替换模式:
事件 移动光标 选择 改变窗口 行动 ~
<LeftMouse> 是 (不能激活) 是
<C-LeftMouse> 是 (不能激活) 是 "CTRL-O^]" (2)
<S-LeftMouse> 是 (不能激活) 是 "CTRL-O*" (2)
<LeftDrag> 是 开始或者扩展 (1) 否 类似于 CTRL-O (1)
<LeftRelease> 是 开始或者扩展 (1) 否 类似于 CTRL-O (1)
<MiddleMouse> 否 (不能激活) 否 放置寄存器内容
<RightMouse> 是 开始或者扩展 是 类似于 CTRL-O
<A-RightMouse> 是 开始或者扩展列块 是
<S-RightMouse> 是 (不能激活) 是 "CTRL-O#" (2)
<C-RightMouse> 否 (不能激活) 否 "CTRL-O CTRL-T"
在帮助窗口里:
事件 移动光标 选择 改变窗口 行动 ~
<2-LeftMouse> 是 (不能激活) 否 "^]" (帮助标签跳转)
当 'mousemodel' 为 "popup" 时,下面这些有所差异:
普通模式:
事件 移动光标 选择 改变窗口 行动 ~
<S-LeftMouse> 是 开始或者扩展 (1) 否
<A-LeftMouse> 是 开始或者扩展列块 否 *<A-LeftMouse>*
<RightMouse> 否 弹出菜单 否
插入或替换模式:
事件 移动光标 选择 改变窗口 行动 ~
<S-LeftMouse> 是 开始或者扩展 (1) 否 类似于 CTRL-O (1)
<A-LeftMouse> 是 开始或者扩展列块 否
<RightMouse> 否 弹出菜单 否
(1) 只有当鼠标在按键后发生移动
(2) 只有当点击发生在同一缓冲区时
点击鼠标左键改变光标的位置。如果点击发生在另一个窗口,那么那个窗口成为活动窗
口。在编辑命令行时,光标只能定位在命令行上。在插入模式下,Vim 仍然保持在插入模
式。如果设置了 'scrolloff',而光标定位在窗口边界 'scrolloff' 行范围内,则文本
被滚动。
在第一个字符上按鼠标左键,移动鼠标到最后一个字符,然后释放,可以进行选择。直到
你释放鼠标键,你不一定总能看到选择的区域。只有一些版本能够 (GUI、MS-DOS、
WIN32) 使得拖动立即显示。注意 如果 'scrolloff' 非零,你可以在窗口的首/ 末行移
动鼠标至少一个字符位置使文本滚动。
在普通、可视和选择模式下,单击鼠标右键使得可视区域被扩展。如果 'mousemodel' 为
'popup',必须使用按住 shift 键的鼠标左键。如果在编辑另外一个缓冲区时点击一个窗
口,可视和选择模式被终止。
在普通、可视和选择模式下,按下 Alt 键同时单击鼠标右键,可使选择区域成为面向列
块。当 'mousemodel' 被设置为 "popup",鼠标左键必须和 Alt 键一起使用。注意在某
些系统中失效,那些系统中的窗口管理器在按下 Alt 键时会吃掉鼠标事件 (可能会移动
窗口)。
*double-click*
双击、三击和四击在 GUI 激活时、MS-DOS 和 Win32,以及 xterm (如果有
gettimeofday() 函数) 上得到支持。对于文本选择,附加的点击会扩展选择区:
点击 选择 ~
两次 单词或者 % 匹配 *<2-LeftMouse>*
三次 行 *<3-LeftMouse>*
四次 矩形区域 *<4-LeftMouse>*
特例: 在帮助窗口上,双击跳到点击的单词对应的帮助。
双击单词选择该单词。'iskeyword' 用来指定单词可以包括哪些字符。双击一个有匹配的
字符选择直到该匹配的区域 (类似于 "v%")。如果匹配是 #if/#else/#endif 块,选择变
为面向行。
MS-DOS 和 xterm 上,双击相隔的时间可以通过 'mousetime' 选项设置。其他系统上,
该值只能在 Vim 之外定义。
一个使用双击跳转到光标所在的标签的例子: >
:map <2-LeftMouse> :exe "tag ". expand("<cword>")<CR>
使用双击拖动鼠标 (按下按钮、抬起按钮、按下按钮、然后拖动) 会导致完整的多个单词
被选择,直到按钮被释放为止。这时选择重新以字符为单位。
*gpm-mouse*
GPM 鼠标只有在编译时打开 |+mouse_gpm| 特性才有效。GPM 鼠标驱动 (Linux 终端) 不
支持四击。
插入模式下,但选择开始时,Vim 暂时回到普通模式。在可视或者选择模式结束时,又回
到插入模式。这类似于在插入模式下使用 CTRL-O 的情形。选择模式在 'selectmode' 选
项包含 "mouse" 时被使用。
*sysmouse*
只有编译时加入 |+mouse_sysmouse| 特性才会支持 sysmouse。sysmouse 驱动 (*BSD 控
制台) 不支持键盘修饰符。
*drag-status-line*
如果有多个窗口一起工作,窗口的大小可以用通过鼠标拖动状态行来改变。把鼠标点在状
态行上,按左键,移动鼠标把状态行带到新的位置,再释放左键。只是用鼠标点击状态行
而不移动鼠标使得那个窗口成为当前窗口。如果选择了一个窗口会改变状态行的位置或大
小,状态行的拖动看起来很奇怪,但还是会工作的 (试试吧)。
*<MiddleRelease>* *<MiddleDrag>*
鼠标点击可以映射。鼠标点击的代码是:
代码 鼠标按钮 一般的行动 ~
<LeftMouse> 按住左键 设置光标位置
<LeftDrag> 按住并移动左键 扩展选择区
<LeftRelease> 释放左键 结束选择区
<MiddleMouse> 按住中键 在光标所在的位置上粘贴
<MiddleDrag> 按住并移动中键 -
<MiddleRelease> 释放中键 -
<RightMouse> 按住右键 扩展选择区
<RightDrag> 按住并移动右键 扩展选择区
<RightRelease> 释放右键 结束选择区
<X1Mouse> 按住 X1 键 - *X1Mouse*
<X1Drag> 按住并移动 X1 - *X1Drag*
<X1Release> 释放 X1 键 - *X1Release*
<X2Mouse> 按住 X2 键 - *X2Mouse*
<X2Drag> 按住并移动 X2 - *X2Drag*
<X2Release> 释放 X2 键 - *X2Release*
X1 和 X2 按钮指一些鼠标上的附加按钮。'Microsoft Explorer' 鼠标在右拇指位置有这
些键。目前 X1 和 X2 只能用于 Win32 和 X11 环境。
示例: >
:noremap <MiddleMouse> <LeftMouse><MiddleMouse>
在鼠标中键点击的位置粘贴 (不然,粘贴在光标所在的位置进行)。
>
:noremap <LeftRelease> <LeftRelease>y
在可视模式下立即抽出选择区。
注意使用了 ":noremap" 而不是 "map",以免发生递归映射。
>
:map <X1Mouse> <C-O>
:map <X2Mouse> <C-I>
把 X1 和 X2 键定义为跳转表的前进和后退,见 |CTRL-O| 和 |CTRL-I|。
**
要交换鼠标左键和右键的含义: >
:noremap <LeftMouse> <RightMouse>
:noremap <LeftDrag> <RightDrag>
:noremap <LeftRelease> <RightRelease>
:noremap <RightMouse> <LeftMouse>
:noremap <RightDrag> <LeftDrag>
:noremap <RightRelease> <LeftRelease>
:noremap g<LeftMouse> <C-RightMouse>
:noremap g<RightMouse> <C-LeftMouse>
:noremap! <LeftMouse> <RightMouse>
:noremap! <LeftDrag> <RightDrag>
:noremap! <LeftRelease> <RightRelease>
:noremap! <RightMouse> <LeftMouse>
:noremap! <RightDrag> <LeftDrag>
:noremap! <RightRelease> <LeftRelease>
<