Links

https://danielmiessler.com/study/vim/#gs.Xg9jNGw

https://www.labnol.org/internet/learning-vim-for-beginners/28820/

Шпаргалка

VimCasts

https://gist.github.com/theotherzach/5033931

Эффективное использование Vim

Минимум один трюк Vim, про который вы не знали

Recipes

" spaces to tabs
%!unexpand -t 2 --first-only
" tabs to spaces
set tabstop=2 shiftwidth=2 expandtab
:retab
" объединяем строки через запятую или запятую с пробелом
" https://vi.stackexchange.com/a/4149/26373
:'<,'>s/\n/,/
:'<,'>s/\n/, /

" Rails.vim - кандидат на альтернативный файл
" можно использовать для создания нового файла
:echo rails#buffer().alternate_candidates()

# --- vim as default editor
sudo update-alternatives --config editor

.gitignore

# Swap
[._]*.s[a-v][a-z]
[._]*.sw[a-p]
[._]s[a-rt-v][a-z]
[._]ss[a-gi-z]
[._]sw[a-p]

# Session
Session.vim
Sessionx.vim

# Temporary
.netrwhist
*~
# Auto-generated tag files
tags
# Persistent undo
[._]*.un~

Commands

View

Buffer Navi

Clipboard

Editing

Find

Visual Mode

Windows

Tabs

link

Reduce & Expand

Macros

Marks

Commentary

commentary.vim - плагин для комментариев

Surround

vim-surround - оборачивание текста в кавычки и скобки

Документация

FZF

https://github.com/junegunn/fzf

git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install

cd ~/.vim-config/.vim/bundle
git clone https://github.com/junegunn/fzf

vimrc

" --- open zfz on Ctrl + P
nnoremap <C-p> :<C-u>FZF<CR>

Grep

Quickfix

Bash

Terminal

Команда :term включает терминал с горизонтальным разделением.

Переход между терминалом и редактором Ctrlw+w

В терминале переход в режим просмотра комбинацией Ctrlw+N

Выход из режима просмотра i или a

Misc

Трансляция кириллицы в латиницу. Позволяет выполнять команды в кириллической раскладке.

https://github.com/powerman/vim-plugin-ruscmd

# переключение курсора между буферами (,l)
let mapleader = ","
nmap <Leader>l <C-w>w

# переключение курсора между буферами (,l)
let mapleader = ","
nmap <Leader>l <C-w>w

Python

https://skillbox.ru/media/code/prevrashchaem-vim-v-polnotsennuyu-ide-dlya-python/

Rails

Rails.Vim

vim-bundler

vim-dispatch

RailsCasts Color Scheme

https://robots.thoughtbot.com/extending-rails-vim-with-custom-commands

https://www.sitepoint.com/effective-rails-development-vim/

https://github.com/smolnar/vim-rails-bundle

https://robots.thoughtbot.com/intro-rails-vim

https://masteruby.github.io/productivity-booster/2014/05/02/vim-plugins-for-ruby.html#.WnCE03omzCI

Golang

vim-go | - полезные команды

git clone https://github.com/fatih/vim-go.git ~/.vim/bundle/vim-go

readme

tagbar - панель со структурой файла

git clone git@github.com:majutsushi/tagbar.git ~/.vim/bundle/vim-tagbar

Добавляем строку в .vimrc

" ~/.vimrc
nmap <F8> :TagbarToggle<CR>

Для корректной работы tagbar требуется ctags.

sudo apt-get install autoconf
git clone git@github.com:universal-ctags/ctags.git
cd ctags
./autogen.sh
./configure
make
sudo make install

vim-compiler-go - проверка синтаксиса

git clone https://github.com/rjohnsondev/vim-compiler-go.git ~/.vim/bundle/vim-compiler-go

В файл .vimrc необходимо прописать путь к директории установки Golang.

" ~/.vimrc
let g:golang_goroot = "/usr/lib/go-1.10"

Узнать полный путь к этой директории можно командой

go env GOROOT

Snippets

https://github.com/SirVer/ultisnips

cd ~/.vim/bundle && git clone git://github.com/SirVer/ultisnips.git
cd ~/.vim/bundle && git clone git://github.com/honza/vim-snippets.git

" ~/.vimrc
" Trigger configuration. Do not use <tab> if you use https://github.com/Valloric/YouCompleteMe.
let g:UltiSnipsExpandTrigger="<tab>"
let g:UltiSnipsJumpForwardTrigger="<c-b>"
let g:UltiSnipsJumpBackwardTrigger="<c-z>"

" If you want :UltiSnipsEdit to split your window.
let g:UltiSnipsEditSplit="vertical"

Открытие редактора снипетов :UltiSnipsEdit Документация :help UltiSnips (или онлайн)

UltiSnips Screencast Episode 1

UltiSnips Screencast Episode 2

Ruby snippets (from procure gem)

global !p
def upperfirst(t):
    if len(t) < 2:
        return '' if len(t) < 1 else t.capitalize()
    return t[0].capitalize() + t[1:]
def lowerdash(t):
    return '-'.join([ w.lower() for w in re.findall('[a-z]+|[A-Z]+[a-z]*', t) ])
def snake(t):
    return '_'.join([ w.lower() for w in re.findall('[a-z]+|[A-Z]+[a-z]*', t) ])
endglobal

snippet llc "one line class"
class $1; end
endsnippet

snippet xc "class with include XML::Mapping"
class ${1}
  include XML::Mapping$0
end
endsnippet

snippet tn "text_node"
text_node :$2`!p snip.rv=snake(t[1])`, '$1'
endsnippet

snippet tno "text_node optional"
text_node :$2`!p snip.rv=snake(t[1])`, '$1', optional: true
endsnippet

snippet opt "optional: true" i
, optional: true
endsnippet

snippet on "object_node"
object_node :$2`!p snip.rv=snake(t[1])`, '$1',
            class: ${3:`!p snip.rv=upperfirst(t[1])`}
endsnippet

# --- EXAMPLES

snippet rc "require package that converts from camelCase or PascalCase to kebab-cased" b
const $1 = require('$2`!p snip.rv=lowerdash(t[1])`');
endsnippet

snippet imp "import package that converts from camelCase or PascalCase to kebab-cased" b
import $1 from '$2`!p snip.rv=lowerdash(t[1])`';
endsnippet

yaml.snippets

# --- TYPES

snippet ta "type array"
description: $1
type: array
items:
  $2
endsnippet

snippet to "type object"
description: $1
type: object
properties:
  $2
endsnippet

snippet ti "type integer"
description: $1
type: integer
nullable: ${2:false}
example: ${3:0}
$0
endsnippet

snippet tf "type float"
description: $1
type: number
format: float
nullable: false
example: ${2:1.23}
$0
endsnippet

snippet ts "type string"
description: $1
type: string
nullable: ${2:false}
example: "${3:string}"
$0
endsnippet

snippet tbs "type binary string"
description: $1
type: string
format: binary
nullable: ${2:false}
$3
endsnippet

snippet tdt "type date-time"
description: $1
type: string
format: date-time
nullable: ${2:false}
$0
endsnippet

snippet turl "type url"
description: $1
type: string
format: uri
nullable: ${2:false}
example: "${3:http://example.com}"
$0
endsnippet

snippet tb "type boolean"
description: $1
type: boolean
default: ${2:false}
nullable: ${3:false}
$0
endsnippet

# --- QUERY PARAMETERS

snippet parip "parameter integer in path"
- name: $1
  in: path
  description: $2
  required: true
  schema:
    type: integer
endsnippet

snippet pars "parameter string in query"
- name: $1
  in: query
  description: $2
  required: ${3:false}
  schema:
    type: string
endsnippet

snippet parsort "parameter for sorting"
- name: sort_by
  in: query
  description: Сортировка записей по заданному полю
  required: false
  schema:
    type: string
    enum: [$1]
$0
endsnippet

snippet parpages "parameter with referenced page and limit"
- $ref: "${1:../../swagger.yaml}#/components/parameters/page"
- $ref: "$1#/components/parameters/limit"
endsnippet

snippet parif "parameter with referenced Id-Modified-Since"
- $ref: "${1:../../swagger.yaml}#/components/parameters/ifmods"
endsnippet

snippet parauth "parameter with referenced Authorization"
- $ref: "#/components/parameters/auth"
endsnippet

# --- REFERENCES

snippet refc "reference to component"
$ref: "${1:../../swagger.yaml}#/components/schemas/$2"
endsnippet

# --- PATHS

snippet pathget "path get"
${1:get}:
  summary: $2
  operationId: `!v expand('%:t:r')`
  tags:
    - $3
  parameters:
  responses:
    "200":
      description: Успешный запрос
      content:
        application/json:
          schema:
    "401":
      $ref: "${4:../../swagger.yaml}#/components/responses/Unauthorized"
endsnippet

snippet pathpost "path post"
post:
  summary: $1
  operationId: ${2:`!v expand('%:t:r')`}
  tags:
    - $3
  requestBody:
    required: true
    content:
      application/json:
        schema:
          type: object
          properties:
        $0
  responses:
    "200":
      description: Успешный запрос
      content:
        application/json:
          schema:
    "401":
      $ref: "${4:../../swagger.yaml}#/components/responses/Unauthorized"
    "422":
      $ref: "$4#/components/responses/UnprocessableEntity"
endsnippet

# --- RESPONSES

snippet 304 "NotModified response"
"404":
  $ref: "${1:../../swagger.yaml}#/components/responses/NotModified"
endsnippet

snippet 404 "NotFound response"
"404":
  $ref: "${1:../../swagger.yaml}#/components/responses/NotFound"
endsnippet

snippet 422 "UnprocessableEntity response"
"422":
  $ref: "${1:../../swagger.yaml}#/components/responses/UnprocessableEntity"
endsnippet

# --- HEADERS

snippet hlast "header Last-Modified"
Last-Modified:
  $ref: "${1:../../swagger.yaml}#/components/headers/Last-Modified"
$0
endsnippet

snippet hpages "header paginate"
X-Total:
  $ref: "${1:../../swagger.yaml}#/components/headers/X-Total"
X-Page:
  $ref: "$1#/components/headers/X-Page"
X-TotalPages:
  $ref: "$1#/components/headers/X-TotalPages"
$0
endsnippet

Syntax highlighting & Themes

http://vimcolors.com/

source

Rails Theme

https://github.com/jpo/vim-railscasts-theme

JS Hightlite

https://github.com/jelera/vim-javascript-syntax

Markdown Highlight

Vim Markdown

" --- отсключение folding по умолчанию
let g:vim_markdown_folding_disabled = 1

Изменение цвета курсора

https://stackoverflow.com/questions/34251566/how-can-i-change-the-cursor-style-in-vim-depending-if-im-in-insert-mode-or-norm

Plugins

Pathogen

Pathogen - плагин для управления плагинами

# устанавливаем плагин
mkdir -p ~/.vim/autoload ~/.vim/bundle && \
curl -LSso ~/.vim/autoload/pathogen.vim https://tpo.pe/pathogen.vim
# корректируем файл конфигурации vim
vim ~/.vimrc

Добавляем строки

execute pathogen#infect()
syntax on
filetype plugin indent on

Плагины, помещенные в директорию ~/.vim/bundle будут активироваться автоматически.

Пример загрузки плагина vim-sensible

cd ~/.vim/bundle && \
git clone https://github.com/tpope/vim-sensible.git

Troubleshooting

Не работает цветовая схема в tmux

Решение https://stackoverflow.com/questions/10158508/lose-vim-colorscheme-in-tmux-mode

Создаем или редактируем файл конфигурации tmux

# ~/.tmux.conf
set -g default-terminal "xterm-256color"

Ошибки при старте vim-config на новом сервере

vim .
...
line   28:
E474: Invalid argument: listchars=tab:>·,trail:~,extends:>,precedes:<,space:.

Возможно установлена некорректная локаль в ОС. Открываем файл ~/.vim-config/vimrc и кириллица будет нарушена.

Решение:

# --- текущая локаль
locale
# --- доступные локали
locale -a
# --- генерация новой (если нет ru_RU.UTF-8)
sudo locale-gen ru_RU.UTF-8
# --- устанавливаем текущую
sudo update-locale LANG=ru_RU.UTF-8

Error detected while processing .vimrc:

Чаще всего на новом сервере при первом запуске vim видим нечто подобное:

Error detected while processing /home/zoid/.vimrc:
line   22:
E474: Invalid argument: listchars=tab:>·,trail:~,extends:>,precedes:<,space:.
Press ENTER or type command to continue

При этом в открытом файле наблюдаем нарушение отображения некоторых символов.

Этом может быть связано с тем, что на сервере не установлена русская локаль:

sudo locale
LANG=en_US
...
sudo locale -a | grep ru
# ничего не выводится

Решение: https://vps.ua/wiki/setting-russian-locale-linux/

sudo apt-get install language-pack-ru
sudo vim /etc/default/locale
# заменяем содержимое на
LANGUAGE=ru_RU:ru
LANG=ru_RU.UTF-8

Буфер обмена

Ubuntu

По-умолчанию vim не поддерживает работу с системным буфером обмена. Для работы с ним необходимо установить vim-gnome вместо vim.

источник

# проверяем поддержку
# -xterm_clipboard - не поддерживается
# +xterm_clipboard - поддерживается
vim --version | grep .xterm_clipboard -o
# удаляем "старый" vim
sudo apt-get purge vim
sudo apt-get autoremove
# устанавливаем "новый"
sudo apt-get install vim-gtk3

Комбинации клавиш "+y - копирование в буфер "+d - вырезание в буфер "+p - вставка из буфера

WSL

https://www.reddit.com/r/bashonubuntuonwindows/comments/be2q3l/how_do_i_copy_whole_text_from_vim_to_clipboard_at/el2vx7u/?utm_source=share&utm_medium=web2x

" WSL yank support
let s:clip = '/mnt/c/Windows/System32/clip.exe'  " change this path according to your mount point
if executable(s:clip)
    augroup WSLYank
        autocmd!
        autocmd TextYankPost * if v:event.operator ==# 'y' | call system(s:clip, @0) | endif
    augroup END
endif

"Зависание" vim

Stackoverflow

В произвольный момент vim "зависает" - перестает отвечать на команды. Причиной тому может служить комбинация Ctrl+S

Лечение - Ctrl-Q