guoqiao's vimrc

I work as Python Developer and DevOps for 10+ years. Vim is my main editor, this repo is the configuration for it.

Quick Start

On Ubuntu or macOS, open a terminal:

Full Install with deps and plugins:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/guoqiao/vimrc/master/setup.sh)"

You can open the setup.sh script to see what it does.

Minimal Install without deps and plugins:

If you don't want plugins, you can just use the vimrc file:

wget https://raw.githubusercontent.com/guoqiao/vimrc/master/vimrc -O ~/.vimrc

Key Features

• work on Debian/Ubuntu Linux and macOS
• use builtin vim pack feature to manage plugins
• plugins are optional

Principles:

• keep it lightweight and minimal, only use necessary config and plugins
• keep it general for both macOS and Debian/Ubuntu
• keep it updated, never stop to absorb new ideas and tools
• keep it easy to use, use most reasonable and handy shortcuts

Useful mapping

• map ; to :, so you don't need to press shift for : each time
• 0 to line begin, <Space> to line end

The leader key

Leader key is , in this vimrc. Related shortcuts:

• remove search result highlight: [leader] + h
• search and replace text: visual select, then [leader] + r to replace
• vim-easymotion: [leader][leader] + w
• edit vimrc: [leader] + ev
• NERD-Commenter: [leader] + ci or ctrl + /
• open current repo line(s) in github/gitlab/bitbucket: [leader] + gh

Tabs

• tn: new tab
• tc: close tab
• to: keep only current tab/close all other tabs
• th: move to left tab
• tl: move to right tab
• tm: move tab to last

Window split

• open split in NerdTree with s or i on file.
• move around splits: ctrl + ww, or ctrl + [hjkl]

plugin settings

• NERDTree: tt to toggle tree, ff to find file in tree(reveal), m + [acd] to add/copy/delete file on tree
• tagbar: TT, toggle tags
• CtrlP: Ctrl + p, search files
• Emmet: Ctrl + y + , expand emmet to html
• vim-indent-object: vii, select text in current indent level
• vim-multiple-cursors: ctrl + n for next, ctrl + b for prev, ctrl + x to skip, esc
• tabular: :Tab/=, = is the char to align
• rm trailing whitespaces: :FixWhitespace
• vim-gh-line: open current code line(s) in browser on github

Debug Vim

option to start vim/nvim in verbose mode:

-V[N][logfile]

N: optional, default to 10, can be 20 or higher. logfile: optional, print to terminal when omit

run with verbose mode:

vim -V
vim -V20
vim -V20vim.log
vim -V20vim.log file.txt

when logfile is provided, in another terminal, tail your log:

tail -f vim.log