diff --git a/README.md b/README.md index a834744..028d689 100644 --- a/README.md +++ b/README.md @@ -1583,10 +1583,71 @@ autocmd ColorScheme * highlight StatusLine ctermbg=darkgray cterm=NONE guibg=dar autocmd ColorScheme lucius highlight StatusLine ctermbg=darkgray cterm=NONE guibg=darkgray gui=NONE ``` -# 命令 -## :global - 在所有匹配行执行命令 -## :normal and :execute - 脚本梦之队 -## :redir - 重定向消息 +## 命令 + +下面的命令都比较有用，最好了解一下。用 `:h :` 来了解更多关于它们的信息，如：`:h :global`。 + + +### :global 和 :vglobal - 在所有匹配行执行命令 + +在所有符合条件的行上执行某个命令。如： `:global /regexp/ print` 会在所有包含 "regexp" 的行上执行 `print` 命令（译者注：regexp 有正则表达式的意思，该命令同样支持正则表达式，在所有符合正则表达式的行上执行指定的命令）。 + +趣闻：你们可能都知道老牌的 grep 命令，一个由 Ken Thompson 编写的过滤程序。它是干什么用的呢？它会输出所有匹配指定正则表达式的行！现在猜一下 `:global /regexp/ print` 的简写形式是什么？没错！就是 `:g/re/p` 。 Ken Thompsom 在编写 grep 程序的时候是受了 vi `:global` 的启发。（译者注： https://robots.thoughtbot.com/how-grep-got-its-name） + +既然它的名字是 `:global`，理应仅作用在所有行上，但是它也是可以带范围限制的。假设你想使用 `:delete` 命令删除从当前行到下一个空行（由正则表达式 `^$` 匹配）范围内所有包含 "foo" 的行： + +```vim +:,/^$/g/foo/d +``` + +如果要在所有 _不_ 匹配的行上执行命令的话，可以使用 `:global!` 或是它的别名 `:vglobal` （ V 代表的是 inVerse ）。 + + + +### :normal 和 :execute - 脚本梦之队 + +这两个命令经常在 Vim 的脚本里使用。 + +借助于 `:normal` 可以在命令行里进行普通模式的映射。如：`:normal! 4j` 会令光标下移 4 行（由于加了"!"，所以不会使用自定义的映射 "j"）。 + +需要注意的是 `:normal` 同样可以使用范围数（译者注：参考 `:h range` 和 `:h :normal-range` 了解更多），故 `:%norm! Iabc` 会在所有行前加上 "abc"。 + +借助于 `:execute` 可以将命令和表达式混合在一起使用。假设你正在编辑一个 C 语言的文件，想切换到它的头文件： + +```vim +:execute 'edit' fnamemodify(expand('%'), ':r') . '.h' +``` + +（译者注：头文件为与与源文件同名但是扩展名为 `.h` 的文件。上面的命令中 expand 获得当前文件的名称，fnamemodify 获取不带扩展名的文件名，再连上 '.h' 就是头文件的文件名了，最后在使用 edit 命令打开这个头文件。） + +这两个命令经常一起使用。假设你想让光标下移 n 行： + +```vim +:let n = 4 +:execute 'normal!' n . 'j' +``` + + +### :redir - 重定向消息 + +许多命令都会输出消息，`:redir` 用来重定向这些消息。它可以将消息输出到文件、[寄存器](#寄存器)或是某个变量中。 + +```vim +" 将消息重定向到变量 `neatvar` 中 +:redir => neatvar +" 打印所有寄存器的内容 +:reg +" 结束重定向 +:redir END +" 输出变量 +:echo neatvar +" 恶搞一下，我们把它输出到当前缓冲区 +:put =neatvar +``` + +（译者注：原文最后一条命令是 `:put =nicevar` 但是实际会报变量未定义的错误） + +帮助文档：`:h :redir` # 调试 ## 常规建议 @@ -1604,13 +1665,122 @@ autocmd ColorScheme lucius highlight StatusLine ctermbg=darkgray cterm=NONE guib ## 复活节彩蛋 ## 为何使用 hjkl -# 怪癖 -## 编辑小文件很慢 -## 编辑大文件很慢 -## 新行用于 NUL -## 相同部分粘贴 (要不为什么我总要设置‘粘贴’?) -## 在终端使用 Esc 延时 -## 无法重复函数中执行的搜索 +## 常见问题 + +### 编辑小文件时很慢 + +有两个因素对性能影响非常大： + +1. 过于复杂的 **正则表达式** 。尤其是 Ruby 的语法文件，以前会造成性能下降。（见[调试语法文件](#debugging-syntax-files)） + +2. **屏幕重绘** 。有一些功能会强制重绘所有行。 + +| 典型肇事者 | 原因 | 解决方案 | +|--------|--------|-----------| +| `:set cursorline` | 会导致所有行重绘 | `:set nocursorline` | +| `:set cursorcolumn` | 会导致所有行重绘 | `:set nocursorcolumn` | +| `:set relativenumber` | 会导致所有行重绘 | `:set norelativenumber` | +| `:set foldmethod=syntax` | 如果语法文件已经很慢了，这只会变得更慢 | `:set foldmethod=manual`，`:set foldmethod=marker` 或者使用[快速折叠](https://github.com/Konfekt/FastFold)插件 | +| `:set synmaxcol=3000` | 由于内部表示法，Vim 处理比较长的行时会有问题。让它高亮到 3000 列…… | `:set synmaxcol=200` | +| matchparen.vim | Vim 默认加载的插件，用正则表达式查找配对的括号 | 禁用插件：`:h matchparen` | + + +**注意**：只有在你真正遇到性能问题的时候才需要做上面的调整。在大多数情况下使用上面提到的选项是完全没有问题的。 + + +### 编辑大文件的时候很慢 + +Vim 处理大文件最大的问题就是它会一次性读取整个文件。这么做是由于缓冲区的内部机理导致的（在 [vim_dev](https://groups.google.com/forum/#!topic/vim_dev/oY3i8rqYGD4/discussion) 中讨论）。 + +如果只是想查看的话，`tail hugefile | vim -` 是一个不错的选择。 + +如果你能接受没有语法高亮，并且禁用所有插件和设置的话，使用： + +```sh +$ vim -u NONE -N +``` + +这将会使得跳转变快很多，尤其是省去了基于很耗费资源的正则表达式的语法高亮。你还可以告诉 Vim 不要使用交换文件和 viminfo 文件，以避免由于写这些文件而造成的延时： + +```sh +$ vim -n -u NONE -i NONE -N +``` + +简而言之，尽量避免使用 Vim 写过大的文件。 + + + +### 持续粘贴（为什么我每次都要设置 'paste' 模式） + +持续粘贴模式让终端模拟器可以区分输入内容与粘贴内容。 + +你有没有遇到过往 Vim 里粘贴代码之后被搞的一团糟？ + +这在你使用 `cmd+v`、`shirt-insert`、`middle-click` 等进行粘贴的时候才会发生。因为那样的话你只是向终端模拟器扔了一大堆的文本。 Vim 并不知道你刚刚是粘贴的文本，它以为你在飞速的输入。于是它想缩进这些行但是失败了。 + +这明显不是个问题，如果你用 Vim 的寄存器粘贴，如：`"+p` ，这时 Vim 就知道了你在粘贴，就不会导致格式错乱了。 + +使用 `:set paste` 就可以解决这个问题正常进行粘贴。见 `:h 'paste'` 和 `:h 'pastetoggle'` 获取更多信息。 + +如果你受够了每次都要设置 `'paste'` 的话，看看这个能帮你自动设置的插件：[bracketed-paste](https://github.com/ConradIrwin/vim-bracketed-paste)。 + +[点此](http://cirw.in/blog/bracketed-paste)查看该作者对于这个插件的更多描述。 + +Neovim 尝试把这些变得更顺畅，如果终端支持的话，它会自动开启持续粘贴模式，无须再手动进行切换。 + + +### 在终端中按 ESC 后有延时 + +如果你经常使用命令行，那么肯定要接触_终端模拟器_，如 xterm、gnome-terminal、iTerm2 等等（与实际的[终端](https://en.wikipedia.org/wiki/Computer_terminal)不同）。 + +终端模拟器与他们的祖辈一样，使用 [转义序列](https://zh.wikipedia.org/wiki/%E8%BD%AC%E4%B9%89%E5%BA%8F%E5%88%97) （也叫_控制序列_）来控制光标移动、改变文本颜色等。转义序列就是以转义字符开头的 ASCII 字符串（用[脱字符表示法](https://zh.wikipedia.org/wiki/%E8%84%B1%E5%AD%97%E7%AC%A6%E8%A1%A8%E7%A4%BA%E6%B3%95)表示成 `^[` ）。当遇到这样的字符串后，终端模拟器会从[终端信息](https://en.wikipedia.org/wiki/Terminfo)数据库中查找对应的动作。 + +为了使用问题更加清晰，我会先来解释一下什么是映射超时。在映射存在歧义的时候就会产生映射超时： + +```vim +:nnoremap ,a :echo 'foo' +:nnoremap ,ab :echo 'bar' +``` + +上面的例子中两个映射都能正常工作，但是当输入 `,a` 之后，Vim 会延时1秒，因为它要确认用户是否还要输入那个 `b`。 + +转义序列会产生同样的问题： + +* `` 作为返回普通模式或取消某个动作的按键而被大量使用 +* 光标键使用转义序列进行的编码 +* Vim 期望 Alt （也叫作 _Mate Key_）会发送一个正确的 8-bit 编码的高位，但是许多终端模拟器并不支持这个（也可能默认没有启用），而只是发送一个转义序列作为代替。 + +你可以这样测试上面所提到的事情： `vim -u NONE -N` 然后输入 `i` ，你会看到一个以 `^[` 开头的字符串，表明这是一个转义序列，`^[` 就是转义字符。 + +简而言之，Vim 在区分录入的 `` 和转义序列的时候需要一定的时间。 + +默认情况下，Vim 用 `:set timeout timeoutlen=1000`，就是说它会用 1 秒的时间来区分有歧义的映射 _以及_ 按键编码。这对于映射来说是一个比较合理的值，但是你可以自行定义按键延时的长短，这是解决该问题最根本的办法： + +```vim +set timeout " for mappings +set timeoutlen=1000 " default value +set ttimeout " for key codes +set ttimeoutlen=10 " unnoticeable small value +``` + +在 `:h ttimeout` 里你可以找到一个关于这些选项之间关系的小表格。 + +而如果你在 tmux 中使用 Vim 的话，别忘了把下面的配置加入到你的 `~/.tmux.conf`文件中： + +``` +set -sg escape-time 0 +``` + + +### 无法重复函数中执行的搜索 + +* 在命令中的搜索（`/`、`:substitute` 等）内容会改变“上次使用的搜索内容”。（它保存在`/`寄存器中，用 `:echo @/` 可以输出它里面的内容） +* 简单的文本变化可以通过 `.` 重做。（它保存在 `.` 寄存器，用 `:echo @.` 可以输出它的内容） + +而在你在函数中进行这些操作的时候，一切就会变得不同。因此你不能用 N/n 查找某个函数刚刚查找的内容，也不能重做函数中对文本的修改。 + +帮助文档：`:h function-search-undo`。 + ## 主题列表 # 插件列表 diff --git a/chapter/Commands.md b/chapter/Commands.md deleted file mode 100644 index 1b5ed4b..0000000 --- a/chapter/Commands.md +++ /dev/null @@ -1,65 +0,0 @@ -## 命令 - -下面的命令都比较有用，最好了解一下。用 `:h :` 来了解更多关于它们的信息，如：`:h :global`。 - - -### :global 和 :vglobal - 在所有匹配行执行命令 - -在所有符合条件的行上执行某个命令。如： `:global /regexp/ print` 会在所有包含 "regexp" 的行上执行 `print` 命令（译者注：regexp 有正则表达式的意思，该命令同样支持正则表达式，在所有符合正则表达式的行上执行指定的命令）。 - -趣闻：你们可能都知道老牌的 grep 命令，一个由 Ken Thompson 编写的过滤程序。它是干什么用的呢？它会输出所有匹配指定正则表达式的行！现在猜一下 `:global /regexp/ print` 的简写形式是什么？没错！就是 `:g/re/p` 。 Ken Thompsom 在编写 grep 程序的时候是受了 vi `:global` 的启发。（译者注： https://robots.thoughtbot.com/how-grep-got-its-name） - -既然它的名字是 `:global`，理应仅作用在所有行上，但是它也是可以带范围限制的。假设你想使用 `:delete` 命令删除从当前行到下一个空行（由正则表达式 `^$` 匹配）范围内所有包含 "foo" 的行： - -```vim -:,/^$/g/foo/d -``` - -如果要在所有 _不_ 匹配的行上执行命令的话，可以使用 `:global!` 或是它的别名 `:vglobal` （ V 代表的是 inVerse ）。 - - - -### :normal 和 :execute - 脚本梦之队 - -这两个命令经常在 Vim 的脚本里使用。 - -借助于 `:normal` 可以在命令行里进行普通模式的映射。如：`:normal! 4j` 会令光标下移 4 行（由于加了"!"，所以不会使用自定义的映射 "j"）。 - -需要注意的是 `:normal` 同样可以使用范围数（译者注：参考 `:h range` 和 `:h :normal-range` 了解更多），故 `:%norm! Iabc` 会在所有行前加上 "abc"。 - -借助于 `:execute` 可以将命令和表达式混合在一起使用。假设你正在编辑一个 C 语言的文件，想切换到它的头文件： - -```vim -:execute 'edit' fnamemodify(expand('%'), ':r') . '.h' -``` - -（译者注：头文件为与与源文件同名但是扩展名为 `.h` 的文件。上面的命令中 expand 获得当前文件的名称，fnamemodify 获取不带扩展名的文件名，再连上 '.h' 就是头文件的文件名了，最后在使用 edit 命令打开这个头文件。） - -这两个命令经常一起使用。假设你想让光标下移 n 行： - -```vim -:let n = 4 -:execute 'normal!' n . 'j' -``` - - -### :redir - 重定向消息 - -许多命令都会输出消息，`:redir` 用来重定向这些消息。它可以将消息输出到文件、[寄存器](#寄存器)或是某个变量中。 - -```vim -" 将消息重定向到变量 `neatvar` 中 -:redir => neatvar -" 打印所有寄存器的内容 -:reg -" 结束重定向 -:redir END -" 输出变量 -:echo neatvar -" 恶搞一下，我们把它输出到当前缓冲区 -:put =neatvar -``` - -（译者注：原文最后一条命令是 `:put =nicevar` 但是实际会报变量未定义的错误） - -帮助文档：`:h :redir` diff --git a/chapter/Common-problems.md b/chapter/Common-problems.md deleted file mode 100644 index 2620dd4..0000000 --- a/chapter/Common-problems.md +++ /dev/null @@ -1,116 +0,0 @@ -## 常见问题 - -### 编辑小文件时很慢 - -有两个因素对性能影响非常大： - -1. 过于复杂的 **正则表达式** 。尤其是 Ruby 的语法文件，以前会造成性能下降。（见[调试语法文件](#debugging-syntax-files)） - -2. **屏幕重绘** 。有一些功能会强制重绘所有行。 - -| 典型肇事者 | 原因 | 解决方案 | -|--------|--------|-----------| -| `:set cursorline` | 会导致所有行重绘 | `:set nocursorline` | -| `:set cursorcolumn` | 会导致所有行重绘 | `:set nocursorcolumn` | -| `:set relativenumber` | 会导致所有行重绘 | `:set norelativenumber` | -| `:set foldmethod=syntax` | 如果语法文件已经很慢了，这只会变得更慢 | `:set foldmethod=manual`，`:set foldmethod=marker` 或者使用[快速折叠](https://github.com/Konfekt/FastFold)插件 | -| `:set synmaxcol=3000` | 由于内部表示法，Vim 处理比较长的行时会有问题。让它高亮到 3000 列…… | `:set synmaxcol=200` | -| matchparen.vim | Vim 默认加载的插件，用正则表达式查找配对的括号 | 禁用插件：`:h matchparen` | - - -**注意**：只有在你真正遇到性能问题的时候才需要做上面的调整。在大多数情况下使用上面提到的选项是完全没有问题的。 - - -### 编辑大文件的时候很慢 - -Vim 处理大文件最大的问题就是它会一次性读取整个文件。这么做是由于缓冲区的内部机理导致的（在 [vim_dev](https://groups.google.com/forum/#!topic/vim_dev/oY3i8rqYGD4/discussion) 中讨论）。 - -如果只是想查看的话，`tail hugefile | vim -` 是一个不错的选择。 - -如果你能接受没有语法高亮，并且禁用所有插件和设置的话，使用： - -```sh -$ vim -u NONE -N -``` - -这将会使得跳转变快很多，尤其是省去了基于很耗费资源的正则表达式的语法高亮。你还可以告诉 Vim 不要使用交换文件和 viminfo 文件，以避免由于写这些文件而造成的延时： - -```sh -$ vim -n -u NONE -i NONE -N -``` - -简而言之，尽量避免使用 Vim 写过大的文件。 - - - -### 持续粘贴（为什么我每次都要设置 'paste' 模式） - -持续粘贴模式让终端模拟器可以区分输入内容与粘贴内容。 - -你有没有遇到过往 Vim 里粘贴代码之后被搞的一团糟？ - -这在你使用 `cmd+v`、`shirt-insert`、`middle-click` 等进行粘贴的时候才会发生。因为那样的话你只是向终端模拟器扔了一大堆的文本。 Vim 并不知道你刚刚是粘贴的文本，它以为你在飞速的输入。于是它想缩进这些行但是失败了。 - -这明显不是个问题，如果你用 Vim 的寄存器粘贴，如：`"+p` ，这时 Vim 就知道了你在粘贴，就不会导致格式错乱了。 - -使用 `:set paste` 就可以解决这个问题正常进行粘贴。见 `:h 'paste'` 和 `:h 'pastetoggle'` 获取更多信息。 - -如果你受够了每次都要设置 `'paste'` 的话，看看这个能帮你自动设置的插件：[bracketed-paste](https://github.com/ConradIrwin/vim-bracketed-paste)。 - -[点此](http://cirw.in/blog/bracketed-paste)查看该作者对于这个插件的更多描述。 - -Neovim 尝试把这些变得更顺畅，如果终端支持的话，它会自动开启持续粘贴模式，无须再手动进行切换。 - - -### 在终端中按 ESC 后有延时 - -如果你经常使用命令行，那么肯定要接触_终端模拟器_，如 xterm、gnome-terminal、iTerm2 等等（与实际的[终端](https://en.wikipedia.org/wiki/Computer_terminal)不同）。 - -终端模拟器与他们的祖辈一样，使用 [转义序列](https://zh.wikipedia.org/wiki/%E8%BD%AC%E4%B9%89%E5%BA%8F%E5%88%97) （也叫_控制序列_）来控制光标移动、改变文本颜色等。转义序列就是以转义字符开头的 ASCII 字符串（用[脱字符表示法](https://zh.wikipedia.org/wiki/%E8%84%B1%E5%AD%97%E7%AC%A6%E8%A1%A8%E7%A4%BA%E6%B3%95)表示成 `^[` ）。当遇到这样的字符串后，终端模拟器会从[终端信息](https://en.wikipedia.org/wiki/Terminfo)数据库中查找对应的动作。 - -为了使用问题更加清晰，我会先来解释一下什么是映射超时。在映射存在歧义的时候就会产生映射超时： - -```vim -:nnoremap ,a :echo 'foo' -:nnoremap ,ab :echo 'bar' -``` - -上面的例子中两个映射都能正常工作，但是当输入 `,a` 之后，Vim 会延时1秒，因为它要确认用户是否还要输入那个 `b`。 - -转义序列会产生同样的问题： - -* `` 作为返回普通模式或取消某个动作的按键而被大量使用 -* 光标键使用转义序列进行的编码 -* Vim 期望 Alt （也叫作 _Mate Key_）会发送一个正确的 8-bit 编码的高位，但是许多终端模拟器并不支持这个（也可能默认没有启用），而只是发送一个转义序列作为代替。 - -你可以这样测试上面所提到的事情： `vim -u NONE -N` 然后输入 `i` ，你会看到一个以 `^[` 开头的字符串，表明这是一个转义序列，`^[` 就是转义字符。 - -简而言之，Vim 在区分录入的 `` 和转义序列的时候需要一定的时间。 - -默认情况下，Vim 用 `:set timeout timeoutlen=1000`，就是说它会用 1 秒的时间来区分有歧义的映射 _以及_ 按键编码。这对于映射来说是一个比较合理的值，但是你可以自行定义按键延时的长短，这是解决该问题最根本的办法： - -```vim -set timeout " for mappings -set timeoutlen=1000 " default value -set ttimeout " for key codes -set ttimeoutlen=10 " unnoticeable small value -``` - -在 `:h ttimeout` 里你可以找到一个关于这些选项之间关系的小表格。 - -而如果你在 tmux 中使用 Vim 的话，别忘了把下面的配置加入到你的 `~/.tmux.conf`文件中： - -``` -set -sg escape-time 0 -``` - - -### 无法重复函数中执行的搜索 - -* 在命令中的搜索（`/`、`:substitute` 等）内容会改变“上次使用的搜索内容”。（它保存在`/`寄存器中，用 `:echo @/` 可以输出它里面的内容） -* 简单的文本变化可以通过 `.` 重做。（它保存在 `.` 寄存器，用 `:echo @.` 可以输出它的内容） - -而在你在函数中进行这些操作的时候，一切就会变得不同。因此你不能用 N/n 查找某个函数刚刚查找的内容，也不能重做函数中对文本的修改。 - -帮助文档：`:h function-search-undo`。 -