A modern, organized Vim configuration with sensible defaults and carefully selected plugins.
This Vim configuration provides a clean, efficient environment for coding with modern features like:
- Code completion
- Syntax checking and linting
- Git integration
- File navigation
- Snippets
- And more...
- Organized plugin structure categorized by functionality
- Documented key mappings for easy reference
- Modern plugin management with vim-plug
- Language-specific settings for consistent formatting
- Productivity enhancements for faster coding
- Vim 8.0+ recommended (minimum 7.4)
- Git
- Node.js (for some language servers)
- Python (for YouCompleteMe)
You can use the provided installation script for a quick setup:
# Clone the repository
git clone [email protected]:cloudartisan/dotvim.git
cd dotvim
# Run the installation script
./install.shOr manually:
# Clone the repository
git clone [email protected]:cloudartisan/dotvim.git ${HOME}/.vim
# Create symlinks
ln -s ${HOME}/.vim/vimrc ${HOME}/.vimrc
ln -s ${HOME}/.vim/vimrc ${HOME}/.gvimrc
# Install vim-plug
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vimAfter the basic installation, you need to install the plugins:
# Install all plugins
vim +PlugInstall +qallThe installation script will automatically install plugins for you if you use it.
The YouCompleteMe plugin requires compilation:
cd $HOME/.vim/bundle/YouCompleteMe
./install.py --clang-completerThis repository includes a test script to verify your vimrc configuration:
# Run the test script from the repository root
./test_vimrc.shThe script checks for:
- Syntax errors in vimrc
- Essential settings
- Plugin structure
- Required plugins
- Key mappings
- Language configurations
Key mappings are documented in the vimrc file. Here's a quick reference:
| Mapping | Description |
|---|---|
\<tab> |
Toggle NERDTree file browser |
\n |
Toggle line numbers |
\p |
Toggle paste mode |
\s |
Toggle sign column |
\l |
Toggle location list |
\q |
Toggle quickfix list |
\t |
Toggle tag browser |
\j |
Go to next error/warning |
\k |
Go to previous error/warning |
Ctrl+h/j/k/l |
Navigate splits (left/down/up/right) |
Add plugins to vimrc between these lines:
call plug#begin()
[...]
call plug#end()Plugin format:
Plug 'username/repo-name'Language-specific settings for indentation, syntax highlighting, etc. are included in the vimrc. Add or modify as needed for your preferred languages.