vim

Fork of vim, an acceptable text editor
git clone git://git.laack.co/vim.git
Log | Files | Refs | README | LICENSE

vim-zh_CN.UTF-8.1 (16477B)


      1 .TH VIM 1 "2025 Jun 27"
      2 .SH 名称
      3 vim \- Vi 改进版 (Vi IMproved),一个面向程序员的文本编辑器
      4 .SH 概述
      5 .br
      6 .B vim
      7 [options] [file ..]
      8 .br
      9 .B vim
     10 [options] \-
     11 .br
     12 .B vim
     13 [options] \-t tag
     14 .br
     15 .B vim
     16 [options] \-q [errorfile]
     17 .PP
     18 .br
     19 .B ex
     20 .br
     21 .B view
     22 .br
     23 .B gvim
     24 .B gview
     25 .B evim
     26 .B eview
     27 .br
     28 .B rvim
     29 .B rview
     30 .B rgvim
     31 .B rgview
     32 .SH 描述
     33 .B Vim
     34 是一个向上兼容 Vi 的文本编辑器。
     35 它可用于编辑各种纯文本文件。
     36 它在编辑程序方面尤为有用。
     37 .PP
     38 相较于 Vi,它有许多增强功能: 多级撤销、多窗口与多缓冲区、语法高亮、命令行编辑、文件名补全、在线帮助、可视化选择等。
     39 关于
     40 .B Vim
     41 与 Vi 之间差异的概要,请参见 ":help vi_diff.txt"。
     42 .PP
     43 在运行
     44 .B Vim
     45 时,可以通过 ":help" 命令从在线帮助系统中获取大量帮助信息。
     46 请参见下文的 "在线帮助" 章节。
     47 .PP
     48 通常,
     49 .B Vim
     50 用于编辑单个文件,可通过以下命令启动:
     51 .PP
     52 	vim file
     53 .PP
     54 更一般地,
     55 .B Vim
     56 可通过以下方式启动:
     57 .PP
     58 	vim [options] [filelist]
     59 .PP
     60 如果未提供 filelist,编辑器将以一个空缓冲区启动。
     61 否则,可使用下列四种方式之一来选择一个或多个要编辑的文件。
     62 .TP 12
     63 file ..
     64 文件名列表。
     65 第一个文件将作为当前文件,并被读入缓冲区。
     66 光标将定位在缓冲区的第一行。
     67 可使用 ":next" 命令切换到其他文件。
     68 如果要编辑以连字符开头的文件,请在文件列表前加 "\-\-"。
     69 .TP
     70 \-
     71 要编辑的文件从标准输入 (stdin) 读取。命令从标准错误 (stderr) 读取,该设备应为终端 (tty)。
     72 .TP
     73 \-t {tag}
     74 根据指定 "tag" 来选择要编辑的文件以及初始光标位置,相当于标签跳转。
     75 会在 tags 文件中查找 {tag},关联的文件会成为当前文件,并执行关联的命令。
     76 这通常用于 C 程序,此时 {tag} 可以是函数名。
     77 效果是包含该函数的文件成为当前文件,光标会定位到该函数的起始处。
     78 参见 ":help tag\-commands"。
     79 .TP
     80 \-q [errorfile]
     81 以快速修复模式启动。
     82 读取 [errorfile] 文件并显示第一个错误。
     83 省略 [errorfile] 时,从 "errorfile" 选项获取文件名 (在 Amiga 上缺省为"AztecC.Err",在其他系统上默认为 "errors.err")。
     84 可使用 ":cn" 命令跳转到后续错误。
     85 参见 "help quickfix"。
     86 .PP
     87 .B Vim
     88 的行为会因命令名称而异 (实际可执行文件可能仍是同一个)。
     89 .TP 10
     90 vim
     91 "正常" 方式,全部使用缺省设置。
     92 .TP
     93 ex
     94 以 Ex 模式启动。
     95 使用 ":vi" 命令进入普通模式。
     96 也可使用 "\-e" 参数实现。
     97 .TP
     98 view
     99 以只读模式启动,防止对文件进行写入。
    100 也可使用 "\-R" 参数实现。
    101 .TP
    102 gvim gview
    103 图形界面版本。
    104 启动一个新窗口。
    105 也可使用 "\-g" 参数实现。
    106 .TP
    107 evim eview
    108 图形界面版本的简易模式。
    109 启动一个新窗口。
    110 也可使用 "\-y" 参数实现。
    111 .TP
    112 rvim rview rgvim rgview
    113 与以上类似,但带有限制。不能启动外壳命令,也不能挂起
    114 .B Vim
    115 。也可使用 "\-Z" 参数实现。
    116 .SH 选项
    117 选项可以以任意顺序给出,位于文件名之前或之后。
    118 无参数的选项可在一个短横后合并 (例如 "\-abc")。
    119 .TP 12
    120 +[num]
    121 对于第一个文件,光标将定位到第 "num" 行。
    122 "num" 省略时,光标将定位到最后一行。
    123 .TP
    124 +/{pat}
    125 对于第一个文件,光标将定位到首次出现 {pat} 的那一行。
    126 可用的搜索模式参见 ":help search\-pattern"。
    127 .TP
    128 +{command}
    129 .TP
    130 \-c {command}
    131 在读取第一个文件后执行 {command}。
    132 {command} 被解释为 Ex 命令。
    133 {command} 含有空格时,必须用双引号括起来 (具体取决于所用的外壳)。
    134 示例: vim "+set si" main.c
    135 .br
    136 注意: 最多可使用 10 个 "+" 或 "\-c" 命令。
    137 .TP
    138 \-A
    139 如果
    140 .B Vim
    141 编译时加入 ARABIC 支持 (用于编辑从右到左的文件并提供阿拉伯键盘映射),
    142 此选项将以阿拉伯模式启动
    143 .B
    144 Vim
    145 ,即置位 'arabic'。否则会给出错误信息并且
    146 .B Vim
    147 退出。
    148 .TP
    149 \-b
    150 二进制模式。
    151 将设置一些选项,以便编辑二进制或可执行文件。
    152 .TP
    153 \-C
    154 兼容模式。置位 'compatible' 选项。
    155 这将使
    156 .B Vim
    157 大体表现得像 Vi,即使存在 .vimrc 文件也是如此。
    158 .TP
    159 \-d
    160 以比较模式启动。
    161 应提供两到八个文件名参数。
    162 .B Vim
    163 会打开所有文件并显示它们之间的差异。
    164 作用与 vimdiff(1) 类似。
    165 .TP
    166 \-d {device}, \-dev {device}
    167 打开 {device} 作为终端使用。
    168 仅在 Amiga 上可用。
    169 示例:
    170 "\-d con:20/30/600/150"。
    171 .TP
    172 \-D
    173 调试。在执行脚本的第一条命令时进入调试模式。
    174 .TP
    175 \-e
    176 以
    177 .B Vim
    178 的 Ex 模式启动,就像可执行文件名为 "ex" 一样。
    179 .TP
    180 \-E
    181 以
    182 .B Vim
    183 的增强 Ex 模式启动,就像可执行文件名为 "exim" 一样。
    184 .TP
    185 \-f
    186 前台。对于 GUI 版本,
    187 .B Vim
    188 不会分叉 (fork) 并从启动时的外壳分离。
    189 在 Amiga 上,
    190 .B Vim
    191 不会重启以打开新窗口。
    192 当
    193 .B Vim
    194 由会等待编辑会话结束的程序 (例如邮件程序) 执行时,应使用此选项。
    195 在 Amiga 上,无法使用 ":sh" 和 ":!" 命令。
    196 .TP
    197 \-F
    198 如果
    199 .B Vim
    200 编译时加入 FKMAP 支持 (用于编辑从右到左的文件并提供波斯语键盘映射),
    201 此选项将以波斯语模式启动
    202 .B Vim
    203 ,即置位 'fkmap' 和 'rightleft'。
    204 否则会给出错误信息并且
    205 .B Vim
    206 退出。
    207 .br
    208 注意: 波斯语支持已在补丁 8.1.0932 中移除。
    209 .TP
    210 \-g
    211 如果
    212 .B Vim
    213 编译时加入 GUI 支持,此选项会启用 GUI。
    214 如果未编译 GUI 支持,会给出错误信息并且
    215 .B Vim
    216 退出。
    217 .TP
    218 \-H
    219 如果
    220 .B Vim
    221 编译时加入 RIGHTLEFT 支持 (用于编辑从右到左的文件并提供希伯来语键盘映射),
    222 此选项将以希伯来模式启动
    223 .B Vim
    224 ,即置位 'hkmap' 和 'rightleft'。
    225 否则会给出错误信息并且
    226 .B Vim
    227 退出。
    228 .TP
    229 \-i {viminfo}
    230 指定读取或写入 viminfo 文件时使用的文件名,替代默认的 "~/.viminfo"。
    231 也可通过指定名称 "NONE" 来跳过使用 .viminfo 文件。
    232 .TP
    233 \-l
    234 Lisp 模式。
    235 开启 'lisp' 和 'showmatch' 选项。
    236 .TP
    237 \-L
    238 等同于 \-r。
    239 .TP
    240 \-m
    241 禁用文件修改。
    242 复位 'write' 选项。
    243 仍可修改缓冲区,但无法写入文件。
    244 .TP
    245 \-M
    246 不允许修改。将复位 'modifiable' 和 'write' 选项,以禁止更改并防止写入文件。
    247 注意这些选项之后可以被重新置位,以再次允许进行修改。
    248 .TP
    249 \-n
    250 不使用交换文件。
    251 发生崩溃后无法恢复。
    252 适用于在非常慢的介质 (例如软盘) 上编辑文件。
    253 也可通过 ":set uc=0" 实现。
    254 可通过 ":set uc=200" 撤销。
    255 .TP
    256 \-N
    257 非兼容模式。复位 'compatible' 选项。
    258 这会使
    259 .B Vim
    260 表现得更好,但与 Vi 的兼容性稍差,即使不存在 .vimrc 文件也会如此。
    261 .TP
    262 \-nb
    263 成为 NetBeans 的编辑器服务器。详见文档。
    264 .TP
    265 \-o[N]
    266 打开 N 个垂直堆叠的窗口。
    267 N 省略时,为每个文件打开一个窗口。
    268 .TP
    269 \-O[N]
    270 打开 N 个并排窗口。
    271 N 省略时,为每个文件打开一个窗口。
    272 .TP
    273 \-p[N]
    274 ] 打开 N 个标签页。
    275 N 省略时,为每个文件打开一个标签页。
    276 .TP
    277 \-P {parent-title}
    278 仅限 Win32 GUI: 指定父应用程序的标题。若可能,Vim 将在该应用程序内的 MDI 窗口
    279 中运行。{parent-title} 必须出现在父应用窗口标题中,且需足够具体。
    280 注意实现仍较为原始;并非所有应用都可用,菜单也不可用。
    281 .TP
    282 \-r
    283 列出交换文件,并提供关于恢复时使用它们的信息。
    284 .TP
    285 \-r {file}
    286 恢复模式。
    287 使用交换文件恢复崩溃的编辑会话。
    288 交换文件与文本文件同名,但附加后缀为 ".swp"。
    289 参见 ":help recovery"。
    290 .TP
    291 \-R
    292 只读模式。
    293 将置位 'readonly' 选项。
    294 仍可编辑缓冲区,但会防止意外覆盖文件。
    295 如果确需覆盖文件,请在 Ex 命令后添加感叹号,例如 ":w!"。
    296 \-R 选项也隐含 \-n 选项 (见上文)。
    297 可用 ":set noro" 来复位 'readonly' 选项。
    298 参见 ":help 'readonly'"。
    299 .TP
    300 \-s
    301 静默模式。仅当以 "Ex" 启动或在 "\-e" 选项之后给出 "\-s" 选项时有效。
    302 .TP
    303 \-s {scriptin}
    304 读取脚本文件 {scriptin}。
    305 文件中的字符将会以键盘输入的方式进行解释。
    306 同样效果也可通过命令 ":source! {scriptin}" 实现。
    307 如果在编辑器退出前到达文件末尾,将继续从键盘读取字符。
    308 .TP
    309 \-S {file}
    310 在读取第一个文件后执行 {file}。
    311 等同于 \-c "source {file}"。
    312 {file} 不能以 '\-' 开头。
    313 {file} 省略时,将使用 "Session.vim" (仅当 \-S 为最后一个参数时生效)。
    314 .TP
    315 \-T {terminal}
    316 告知
    317 .B Vim
    318 正在使用的终端名称。
    319 仅当自动检测失败时需要。
    320 应为
    321 .B Vim
    322 已知 (内置) 或在 termcap/terminfo 文件中定义的终端。
    323 .TP
    324 \-u {vimrc}
    325 使用 {vimrc} 文件中的命令进行初始化。
    326 其他所有初始化将被跳过。
    327 用于编辑特定类型的文件。
    328 也可通过指定名称 "NONE" 跳过所有初始化。
    329 详见 Vim 内的 ":help initialization"。
    330 .TP
    331 \-U {gvimrc}
    332 使用 {gvimrc} 文件中的命令进行 GUI 初始化。
    333 其他所有 GUI 初始化将被跳过。
    334 也可通过指定名称 "NONE" 跳过所有 GUI 初始化。
    335 详见 Vim 内的 ":help gui\-init"。
    336 .TP
    337 \-v
    338 以
    339 .B Vim
    340 的 Vi 模式启动,就像可执行文件名为 "vi" 一样。仅当可执行文件名为 "ex" 时有效。
    341 .TP
    342 \-V[N]
    343 详细模式。输出关于哪些文件被执行以及读取/写入 viminfo 文件的消息。可选数值 N
    344 为 'verbose' 的值,缺省值为 10。
    345 .TP
    346 \-V[N]{filename}
    347 和 \-V 类似,但同时设置 'verbosefile' 为 {filename}。此时消息不显示,而写入
    348 {filename} 文件。{filename} 不能以数位开头。
    349 .TP
    350 \-w{number}
    351 将 'window' 选项设置为 {number}。
    352 .TP
    353 \-w {scriptout}
    354 用户输入的所有字符将被记录到文件 {scriptout},直到退出
    355 .B Vim
    356 为止。如果要创建用于 "vim \-s" 或 ":source!" 的脚本文件,这很有用。
    357 如果 {scriptout} 文件已存在,新内容将追加到该文件末尾。
    358 .TP
    359 \-W {scriptout}
    360 和 \-w 类似,但会覆盖已存在的文件。
    361 .TP
    362 \-x
    363 如果
    364 .B Vim
    365 编译时加入加密支持,写入文件时使用加密。
    366 会提示输入加密密钥。
    367 .TP
    368 \-X
    369 不连接到 X 服务器。在终端中可缩短启动时间,但无法使用窗口标题和剪贴板。
    370 .TP
    371 \-Y
    372 不连接到 wayland 合成器。
    373 .TP
    374 \-y
    375 以
    376 .B Vim
    377 的简易模式启动,就像可执行文件名为 "evim" 或 "eview" 一样。
    378 使
    379 .B Vim
    380 表现为点击输入式的编辑器。
    381 .TP
    382 \-Z
    383 受限模式。就像可执行文件以 "r" 开头一样。
    384 .TP
    385 \-\-
    386 标记选项结束。
    387 其后的参数将作为文件名处理。
    388 这可用于编辑以 '\-' 开头的文件名。
    389 .TP
    390 \-\-clean
    391 不使用任何个人配置 (vimrc、插件等)。用于在干净 Vim 环境下检查问题是否可复现。
    392 .TP
    393 \-\-cmd {command}
    394 和 "\-c" 类似,但在处理任何 vimrc 文件之前先执行命令。
    395 最多可使用 10 个此类命令,与 "\-c" 命令互不影响。
    396 .TP
    397 \-\-echo\-wid
    398 仅限 GTK GUI: 在标准输出上回显窗口 ID。
    399 .TP
    400 \-\-gui\-dialog\-file {name}
    401 使用 GUI 时,不显示对话框,而是将对话框的标题和消息写入文件 {name}。
    402 该文件会被创建或追加写入。仅用于测试,以避免测试卡在不可见的对话框上。
    403 未使用 GUI 时忽略此参数。
    404 .TP
    405 \-\-help, \-h, \-?
    406 提供关于命令行参数和选项的简要帮助。
    407 之后
    408 .B Vim
    409 退出。
    410 .TP
    411 \-\-literal
    412 按本义处理文件名参数,不展开通配符。在 Unix 上无效,因为外壳总会展开通配符。
    413 .TP
    414 \-\-log {filename}
    415 如果
    416 .B Vim
    417 编译时加入 eval 和 channel 特性,启动日志记录并将条目写入 {filename}。
    418 其效果类似在启动早期调用
    419 .I ch_logfile({filename}, 'ao')。
    420 .TP
    421 \-\-nofork
    422 前台。对于 GUI 版本,
    423 .B Vim
    424 不会分叉 (fork) 并从启动时的外壳分离。
    425 .TP
    426 \-\-noplugin
    427 跳过插件的加载。\-u NONE 会隐含本选项。
    428 .TP
    429 \-\-not\-a\-term
    430 告知
    431 .B Vim
    432 用户知道输入和/或输出未连接到终端。这将避免出现警告及随后的两秒延迟。
    433 .TP
    434 \-\-remote
    435 连接到一个 Vim 服务器,并让其编辑后续参数中给出的文件。若未找到服务器,将给出警告并在当前 Vim 中编辑这些文件。
    436 .TP
    437 \-\-remote\-expr {expr}
    438 连接到 Vim 服务器,在其中计算 {expr} 并将结果打印到标准输出。
    439 .TP
    440 \-\-remote\-send {keys}
    441 连接到 Vim 服务器并发送 {keys}。
    442 .TP
    443 \-\-remote\-silent
    444 同 \-\-remote,但在未找到服务器时不显示警告。
    445 .TP
    446 \-\-remote\-wait
    447 同 \-\-remote,但 Vim 在文件编辑完成之前不会退出。
    448 .TP
    449 \-\-remote\-wait\-silent
    450 同 \-\-remote\-wait,但在未找到服务器时不显示警告。
    451 .TP
    452 \-\-serverlist
    453 列出可发现的所有 Vim 服务器的名称。
    454 .TP
    455 \-\-servername {name}
    456 将 {name} 用作服务器名称。用于当前 Vim,除非与
    457 \-\-remote 参数一起使用,此时它是要连接的服务器名称。
    458 若使用 socketserver 后端,且名称以 "/"、"./" 或 "../"开头,则视为指向该套接字的绝对、相对或相对路径。
    459 .TP
    460 \-\-clientserver {backend}
    461 将 {backend} 用作 clientserver 功能的后端,分别为 "socket" 或 "x11"。
    462 仅在编译时同时加入 socketserver 和 X11 特性时可用。
    463 .TP
    464 \-\-socketid {id}
    465 仅限 GTK GUI: 使用 GtkPlug 机制在另一个窗口中运行 gVim。
    466 .TP
    467 \-\-startuptime {file}
    468 在启动期间将计时消息写入文件 {fname}。
    469 .TP
    470 \-\-ttyfail
    471 当 stdin 或 stdout 不是终端 (tty)时,立即退出。
    472 .TP
    473 \-\-version
    474 打印版本信息并退出。
    475 .TP
    476 \-\-windowid {id}
    477 仅限 Win32 GUI: 使 gVim 尝试使用窗口 {id} 作为父窗口,从而在该窗口内运行。
    478 .SH 在线帮助
    479 在
    480 .B Vim
    481 中输入 ":help" 即可开始使用帮助系统。
    482 输入 ":help 主题" 可以查看某个特定主题的帮助。
    483 例如: 输入 ":help ZZ" 可查看 "ZZ" 命令的帮助。
    484 使用 <Tab> 和 CTRL-D 可以补全主题名称 (参见 ":help cmdline-completion")。
    485 文档中包含标签,可在不同位置之间跳转 (类似于超文本链接,参见 ":help")。
    486 所有文档文件都可以通过这种方式查看,例如:
    487 ":help syntax.txt"。
    488 .SH 文件
    489 .TP 15
    490 /usr/local/share/vim/vim??/doc/*.txt
    491 .B Vim
    492 文档文件。
    493 可用 ":help doc\-file\-list" 获取完整文档列表。
    494 .br
    495 其中,
    496 .I vim??
    497 为短版本名,例如 vim91 代表
    498 .B Vim 9.1
    499 。
    500 .TP
    501 /usr/local/share/vim/vim??/doc/tags
    502 用于在文档文件中查找信息的标签文件。
    503 .TP
    504 /usr/local/share/vim/vim??/syntax/syntax.vim
    505 系统范围的语法初始化代码。
    506 .TP
    507 /usr/local/share/vim/vim??/syntax/*.vim
    508 不同语言的语法文件。
    509 .TP
    510 /usr/local/share/vim/vimrc
    511 系统范围的
    512 .B Vim
    513 初始化代码。
    514 .TP
    515 ~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc
    516 用户个人的
    517 .B Vim
    518 初始化代码 (使用首个找到的文件)。
    519 .TP
    520 /usr/local/share/vim/gvimrc
    521 系统范围的 gvim 初始化代码。
    522 .TP
    523 ~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc
    524 用户个人的
    525 .B gVim
    526 初始化代码 (使用首个找到的文件)。
    527 .TP
    528 /usr/local/share/vim/vim??/optwin.vim
    529 用于 ":options" 命令的脚本,这是一个用于查看和设置选项的便捷方式。
    530 .TP
    531 /usr/local/share/vim/vim??/menu.vim
    532 系统范围用于
    533 .B gVim
    534 的菜单初始化代码。
    535 .TP
    536 /usr/local/share/vim/vim??/bugreport.vim
    537 用于生成漏洞报告的脚本。参见 ":help bugs"。
    538 .TP
    539 /usr/local/share/vim/vim??/filetype.vim
    540 用于根据文件名检测文件类型的脚本。参见 ":help 'filetype'"。
    541 .TP
    542 /usr/local/share/vim/vim??/scripts.vim
    543 用于根据文件内容检测文件类型的脚本。参见 ":help 'filetype'"。
    544 .TP
    545 /usr/local/share/vim/vim??/print/*.ps
    546 用于 PostScript 打印的文件。
    547 .PP
    548 如需获取最新信息,请阅读 VIM 官方主页:
    549 .br
    550 <URL:http://www.vim.org/>
    551 .SH 另见
    552 vimtutor(1)
    553 .SH 作者
    554 绝大多数
    555 .B Vim
    556 代码由 Bram Moolenaar 完成,同时得到许多其他人士的帮助。
    557 参见
    558 .B Vim
    559 中的 ":help credits"。
    560 .br
    561 .B Vim
    562 基于由 Tim Thompson、Tony Andrews 和 G.R. (Fred) Walter 编写的 Stevie。
    563 不过,绝大多数原始代码已被重写。
    564 .SH 漏洞
    565 有可能。
    566 已知问题的列表可参见 ":help todo"。
    567 .PP
    568 请注意,某些被认为是漏洞的现象,实际上源于对 Vi 行为的高度忠实复制。
    569 如果仅因为 Vi 的表现不同而认为某些行为是漏洞,请参阅 vi_diff.txt 文件 (或在Vim 中执行 :help vi_diff.txt)。
    570 同时请查阅 'compatible' 与 'cpoptions' 选项。