From Vim to Emacs+Evil chaotic migration guide
I've been using Vim for 18 years, and for me it was the only option for serious text work (like programming or writing) because I'm totally addicted to modal text editing to the point that I feel crippled when I've to edit text in a non-modal editor. You may argue that programming is not about how fast you write and you would be right, but if you can imagine somebody programming on an on screen keyboard on a tablet, you know how modal editor users feel about non modal edition.
But as many Vimmers, I was always curious about Emacs (the enemy in the editor flamewars!), it's operating-system-in-a-window and the Lisp virtual machines concepts but the non-modal editing and the low quality of the existing modal editing modes compared with Vim made me keep a sane distance from it.
But then, Evil-mode happened. Evil mode is being developed as a perfect Vim emulation for Emacs. Some of its developers have publicly stated that Vim is the model and if something works differently than in Vim it should be marked as a bug. I've been hearing very good things about Evil-mode, and when some of my old Vimmers contacts made the switch I knew the mode should be very good.
So two weeks ago I installed Emacs and Evil and started to configure everything to my liking. My first objective was to have an editing environment as efficient as the one I've in Vim, with the same plugins and shortcuts. I didn't expected to really reach that point in a long time, because I heard than Emacs has less plugins than Vim and I expected to have a hard time creating my dotfiles using Elisp. After two weeks of intense investigation, googling, Elisp accelerated learning, reading of other people's dotfiles and tinkering I can say that I was very wrong. Not only I've an environment where I didn't lost almost anything to my highly-tuned Vim, but I also got gains in some other areas (and I still haven't started to play with the famous Org mode or Gnus).
This article is a pretty chaotic recollection of bits about how I turned Emacs into my Vim, and then how I improved over it. Most of the items will be bits of Elisp code for the config file or info about plugins. My hope is that this article will be useful to other Vim power users trying Emacs+Evil because I would have loved to find an article like this when I was starting.
This article has been written with the help of lot of random people whose configs, articles an answers I had the luck to land after some internet search, mostly from StackOverflow, GitHub, and random forums. To keep the article clean, I don't always cite the source of the snippets but you could easily find most of them just googling the code.
You can also check my Emacs' dotfiles if you're interested, but remember that these are newbie dotfiles so I'm probably doing something stupid on them. As you'll see, my config is split between several files. I advise you to don't do this from the start, but to dump everything into your .emacs file because it is easier to experiment and change a lot when you're starting (and if you're a little like me you'll be playing a lot with your config) and once you've more or less settled on a config, split it into categories. Oh, and keep Vim at hand to fix your Emacs config the several times you'll broke it.
A good Windows version
I've to use Windows at work and I was having a lot of problems with the official version of Emacs for Windows (slowness, unstability, huge memory usage spikes...). Reddit's user tuhdo read about my woes and suggested two versions of third party packages of Windows Emacs. I've tested both and I can say that this one is definitively the best and solves all my problems.
Basic Emacs survival keys
If you're a Vim user after installing Evil you'll be using Vim-style commands most of the time, but to install Evil first and for some modes where Evil doesn't work (like the package manager) you'll need some basic cheatsheet of Emacs commands.
- C-g (that is Control and g at the same time) to cancel prompts. Later we'll remap the escape key to do the same which anyone coming from Vim will need to retain its sanity.
- C-x k to kill (close) a buffer. Automatically opened windows are usually closeable with "q".
- C-x o (that's an "o" not a zero) to rotate between window
- C-x 2 to create an horizontal split (window)
- C-x 3 to create a vertical split
- M-x (M = Alt on PC) shows the "minibuffer" where you can call Emacs functions. Later I'll show how to improve it a lot.
- To toggle long lines wrapping (like set wrap/nowrap in Vim), do M-x visual-line-mode RET.
- C-y: yank/paste. The only way to paste on the modeline even when you're using Evil.
The integrated plugin (package in emacspeak) manager is pretty good. It lists,
downloads, updates and install the packages in a breeze. I've tested almost all of
Vim's plugin managers and neither of them is close to this. You start it with
list-packages (enter to install, d to delete, x to execute deletions).
To add more sources to the package managers and to have a function that will load packages and install them if missing (useful if you move your config between computers) put this on your config file:
;; packages (setq package-archives '(("gnu" . "http://elpa.gnu.org/packages/") ("org" . "http://orgmode.org/elpa/") ("marmalade" . "http://marmalade-repo.org/packages/") ("melpa-stable" . "http://melpa-stable.milkbox.net/packages/"))) (package-initialize) (defun require-package (package) (setq-default highlight-tabs t) "Install given PACKAGE." (unless (package-installed-p package) (unless (assoc package package-archive-contents) (package-refresh-contents)) (package-install package)))
Note: as Phil suggested in the comments, the non-stable Melpa repository is risky to have for newbies since it pulls directly from git master, I've used melpa-stable in the config example, if you want to use Melpa just remove the "-stable" from both the name and URL in the config.
Evil (Vim emulation)
It's fucking impressive. I don't miss any text command, operator, motion or work flow from Vim. Marks, paragraph reformatting, visual mode, visual block, macros, registers, text objects, splits (vertical, horizontal, :normal, folding, etc)... it has almost everything.
Of course Vim plugins doesn't work, but there are Emacs or Evil alternatives for most of them.
You can use M-x load-theme RET to check the available themes (you can install more
with the package manager). Once you have chosen one theme, put in .emacs:
(load-theme 'misterioso t).
By default, most themes look like shit on terminal Emacs (emacs -nw if you don't
want the window to open). On Vim some themes too, but in Emacs this happens with
almost all of them. This can improve a lot installing the color-theme-approximate
package with makes the same thing as CSApprox in Vim: translate colors to their
console equivalents. Once installed add this to your .emacs:
(color-theme-approximate-on). If it doesn't work try to put the line lower in
the .emacs file (it happened to me). If everything still look like shit check that
you have the correct TERM environment variable set (hint: is different inside
screen or tmux).
Change cursor color depending on mode
This is something that I liked to have in Vim. Fortunately, you can also have it in Emacs. Unfortunately, I've been unable to get in working on non-GUI emacs:
(setq evil-emacs-state-cursor '("red" box)) (setq evil-normal-state-cursor '("green" box)) (setq evil-visual-state-cursor '("orange" box)) (setq evil-insert-state-cursor '("red" bar)) (setq evil-replace-state-cursor '("red" bar)) (setq evil-operator-state-cursor '("red" hollow))
If you install the evil-tabs package and enable it with
t) you'll have
gt and friends with numbered tabs by default. Showing
the tab number is a very useful feature when you can change to a tab with
like in Vim (with
# being a number from 0 to 9), but unfortunately this package
#gt but I worked it around with my awesome Elisp skills (close
(define-key evil-normal-state-map (kbd "C-0") (lambda() (interactive) (elscreen-goto 0))) (define-key evil-normal-state-map (kbd "C- ") (lambda() (interactive) (elscreen-goto 0))) (define-key evil-normal-state-map (kbd "C-1") (lambda() (interactive) (elscreen-goto 1))) (define-key evil-normal-state-map (kbd "C-2") (lambda() (interactive) (elscreen-goto 2))) (define-key evil-normal-state-map (kbd "C-3") (lambda() (interactive) (elscreen-goto 3))) (define-key evil-normal-state-map (kbd "C-4") (lambda() (interactive) (elscreen-goto 4))) (define-key evil-normal-state-map (kbd "C-5") (lambda() (interactive) (elscreen-goto 5))) (define-key evil-normal-state-map (kbd "C-6") (lambda() (interactive) (elscreen-goto 6))) (define-key evil-normal-state-map (kbd "C-7") (lambda() (interactive) (elscreen-goto 7))) (define-key evil-normal-state-map (kbd "C-8") (lambda() (interactive) (elscreen-goto 8))) (define-key evil-normal-state-map (kbd "C-9") (lambda() (interactive) (elscreen-goto 9))) (define-key evil-insert-state-map (kbd "C-0") (lambda() (interactive) (elscreen-goto 0))) (define-key evil-insert-state-map (kbd "C- ") (lambda() (interactive) (elscreen-goto 0))) (define-key evil-insert-state-map (kbd "C-1") (lambda() (interactive) (elscreen-goto 1))) (define-key evil-insert-state-map (kbd "C-2") (lambda() (interactive) (elscreen-goto 2))) (define-key evil-insert-state-map (kbd "C-3") (lambda() (interactive) (elscreen-goto 3))) (define-key evil-insert-state-map (kbd "C-4") (lambda() (interactive) (elscreen-goto 4))) (define-key evil-insert-state-map (kbd "C-5") (lambda() (interactive) (elscreen-goto 5))) (define-key evil-insert-state-map (kbd "C-6") (lambda() (interactive) (elscreen-goto 6))) (define-key evil-insert-state-map (kbd "C-7") (lambda() (interactive) (elscreen-goto 7))) (define-key evil-insert-state-map (kbd "C-8") (lambda() (interactive) (elscreen-goto 8))) (define-key evil-insert-state-map (kbd "C-9") (lambda() (interactive) (elscreen-goto 9)))
Somebody with better Elisp skills please help me with a less kludgy solution, but
this works (and it's in fact one key press less than
In order to define an use a
<leader> prefix for your personal shortcuts you have
to install the package evil-leader and put lines like these on your .emacs (I use
comma as a leader key):
(global-evil-leader-mode) (evil-leader/set-leader ",")
Later, I found that the
(setq evil-leader/in-all-states 1)
Sessions (:mksession in Vim)
Emacs have the commands
M-x desktop-save and
desktop-read. To have it
automatically saved/restored put into the .emacs:
(desktop-save-mode 1). If you
want to start emacs without auto loading the session (if you configured it), the
emacs --no-desktop. But Emacs sessions doesn't know about elscreens
(which evil-tabs use for creating Vim-like tabs) so if you want to save and
restore full sessions including tabs copy these functions into your config file
and assign them some shortcut:
;; Save session including tabs ;; http://stackoverflow.com/questions/22445670/save-and-restore-elscreen-tabs-and-split-frames (defun session-save () "Store the elscreen tab configuration." (interactive) (if (desktop-save emacs-configuration-directory) (with-temp-file elscreen-tab-configuration-store-filename (insert (prin1-to-string (elscreen-get-screen-to-name-alist)))))) ;; Load session including tabs (defun session-load () "Restore the elscreen tab configuration." (interactive) (if (desktop-read) (let ((screens (reverse (read (with-temp-buffer (insert-file-contents elscreen-tab-configuration-store-filename) (buffer-string)))))) (while screens (setq screen (car (car screens))) (setq buffers (split-string (cdr (car screens)) ":")) (if (eq screen 0) (switch-to-buffer (car buffers)) (elscreen-find-and-goto-by-buffer (car buffers) t t)) (while (cdr buffers) (switch-to-buffer-other-window (car (cdr buffers))) (setq buffers (cdr buffers))) (setq screens (cdr screens))))))
Accents didn't work for me on GUI mode, only in text mode. That was fixed adding
(require 'iso-transl) to my .emacs.
"After" macro definition
I have an "after" macro defined that I copied from someone config file (can't remember who - sorry). This is useful to specifiy code to be executed after some plugin has loaded.
The definition is on my config file as:
;; "after" macro definition (if (fboundp 'with-eval-after-load) (defmacro after (feature &rest; body) "After FEATURE is loaded, evaluate BODY." (declare (indent defun)) `(with-eval-after-load ,feature ,@body)) (defmacro after (feature &rest; body) "After FEATURE is loaded, evaluate BODY." (declare (indent defun)) `(eval-after-load ,feature '(progn ,@body))))))
Vim-like search highlighting
I prefer how Vim's highlight search and left the highlighted terms until you make
another search or clean the highlighted terms. I tough this would be easy to get
but it turned it wasn't so easy (for me). At the end I made my first Emacs
extension (and the first time I've programmed in Lisp since the university a long
time ago...) so all turned well. The extension is already on Melpa has the
very brief name of
evil-search-highlight-persist. You can enable it with:
(require 'evil-search-highlight-persist) (global-evil-search-highlight-persist t)
To map a shortcut (leader-space) to clear the highlights I have:
(evil-leader/set-key "SPC" 'evil-search-highlight-persist-remove-all)
I must note that another good way to search in Emacs is to use
helm-occur. This will show the search results on a list (on a split window with
occur) and you'll be able to jump easily to any match.
Helm: Unite/CtrlP style fuzzy file/buffer/anything searcher on steroids
Helm does the same thing as Unite/CtrlP on Vim and does it really well. You can
also enable Helm to manage the command buffer, which is pretty awesome with:
(helm-mode 1) in the .emacs file. I also configured a shortcut in normal mode,
SPACE SPACE which is the same I was using with Vim. This can be done with:
(define-key evil-normal-state-map " " 'helm-mini).
But Helm can be really configurable and you can include or exclude modules in the helm interface show with the shortcut associated to your config, for example I've:
;; helm settings (TAB in helm window for actions over selected items, ;; C-SPC to select items) (require 'helm-config) (require 'helm-misc) (require 'helm-projectile) (require 'helm-locate) (setq helm-quick-update t) (setq helm-bookmark-show-location t) (setq helm-buffers-fuzzy-matching t) (after 'projectile (package 'helm-projectile)) (global-set-key (kbd "M-x") 'helm-M-x) (defun helm-my-buffers () (interactive) (let ((helm-ff-transformer-show-only-basename nil)) (helm-other-buffer '(helm-c-source-buffers-list helm-c-source-elscreen helm-c-source-projectile-files-list helm-c-source-ctags helm-c-source-recentf helm-c-source-locate) "*helm-my-buffers*")))
Here, I define a "helm-my-buffers" function that when called (assign a shortcut to
it!) will show Helm interface but searching (fuzzy, real time as you write,
unordered) in open buffers, recent files, project files (see below for more on
that), tags inside the files, tabs and results from the Linux command
that searches quickly from a database of all the files in the file system. How
awesome is that?
But this is only the tip of the iceberg of Helm power. There are
searching the symbols (functions, classes, globals, etc) in the current buffer
helm-imenu), bookmarks (including Chrome/Firefox bookmarks), HTML colors
(showing the color, name, and hexadecimal code), apt packages and more.
If you check the sources of the
helm-my-buffers function above you can see that
I'm also using
helm-c-source-projectile-files-list. This will use another
installable third party package called Projectile that will search for a
git/hg/svn file in the current directory and its parents and extract the current
project files. Linking it will Helm makes it super easy to open any file in your
current project (providing you've it under version control) without having the
browse the filesystem, even for files that you have never opened (and thus are not
in Emacs' recent files list).
Another good combination of Helm with a nice Emacs feature (this time included by default) is helm-imenu. iMenu is a pretty smart minor mode that extract "locations" inside a buffer. For code in a programming language this will be typically the classes, methods and other symbols. Calling helm-imenu instead of the default imenu will make it very easy to jump quickly to a location inside the buffer just writing a couple of letters.
Another great feature of Helm is the chance to replace the default "M-x" menu
interface. M-x is what you use to issue Emacs commands, a little like ":" in Vim
(but only a little, ex mode in Vim or Evil is another kind of animal). One great
thing about Emacs is that it has commands and modes for a lot of things, and with
Helm M-x you don't have to learn them all. For example if I don't remember how to
show white space characters I just press M-x and start to write
Helm will show me as first result
whitespace-mode which is exactly what I want
(it also showed
whitespace-cleanup that clears all the trailing whitespace and
that is how I discovered it). Want to check the commands related to spelling?
spell. How to list errors in the code with flycheck?
M-x fly errors. How to
sort the lines of a selection?
M-x sort. This is really convenient and as an
Emacs newbie I get a lot of things done just searching in Helm-M-x without having
to search on Google. You can map Helm-M-x to M-x with:
(global-set-key (kbd "M-x") 'helm-M-x)
There is another package that also helps when learning to use a specific mode,
it's called "Discover My Major" (
discover-my-major in Melpa). Invoking the
command with the same name will show all the functions enabled by the current
major mode. It's great to discover what every mode can do.
There is another package that also helps when learning to use a specific mode,
it's called "Discover My Major" (
discover-my-major in Melpa). Invoking the
command with the same name will show all the functions enabled by the current
major mode. It's great to discover what every mode can do.
Edit: thanks to tuhdo in the comments who told me how to show the full path of the files in the helm-recentf sources).
Vim's Marks => Evil's Marks + Emacs' Bookmarks
Evil has marks just like Vim:
m to jump to a mark,
m-letter to set a mark,
m-uppercase_letter to set a mark that works between buffers. But while marks are
pretty useful for example to quickly jump between two or three positions inside
some files when you're coding, Emacs also has the concept of "bookmarks" that are
like inter-file marks that you can set with a name (instead of a letter) and that
with the elisp bit below in your config file can be saved between sessions. I'm
helm-bookmarks to see and set them, which I've mapped to
SPC-b. To delete
TAB inside the helm sub-window to see the list of actions and
choose "Delete Bookmark(s)".
;; save bookmarks (setq bookmark-default-file "~/.emacs.d/bookmarks" bookmark-save-flag 1) ;; save after every change
Folding... and narrowing!
Folding with Evil works as expected, using the same operators that in Vim (with
the added benefit that if you're using Helm-M-x you can do
M-x RET fold to
search the folding commands in case you forgot the Vim-style operator). Emacs also
support an interesting feature called "narrowing". Narrowing will hide everything else
in the file except the narrowed function or region. This is pretty useful when you
want to make global replaces or run some macro but don't want to affect the other
parts of the buffer. I don't use it much so I haven't assigned any shortcut, I
just use the commands
narrow-to-defun. Once you have
finished working on the narrowed region, you can display the rest of the buffer
again with the
I've already mentioned Projectile that combined with Helm makes searching for project files very convenient, but there are other options. One of them is project-explorer, which is pretty much like Vim "project" script: when you enable it it will show a side split (sorry, window) with your project files. With Helm + Helm-Projectile + the file explorer it's rarely needed but from time to time it's nice to have a tree view of a source code project (more if the code isn't yours). The Windows can be opened with the command "project-explorer-open" (I didn't assign any shortcut to it). One thing to note if you're using Evil is that the shortcuts like TAB to toggle a folder subtree only work if you're in insert mode.
(package 'project-explorer) (after 'project-explorer (setq pe/cache-directory "~/.emacs.d/cache/project_explorer") (setq pe/omit-regex (concat pe/omit-regex "\\|single_emails")))
Ctags => Etags
Emacs use a tags file format with a syntax that is different from the "default"
ctags called "etags". Generating etags is easy since Exuberant-Ctags already know
how to generate them (just add a
-e switch). Emacs distributions usually came
with an etags binary (I'm using ctags because there is a patched version with
support for the D language but Emacs's etag binary doesn't support it).
Once generated Emacs will ask you where the tags file is the first time you use
any tag command (like
evil-jump-to-tag to jump to the specified
tag) and once loaded it will remember it (at least for the current session, I
still need to find how to make it remember the path between sessions).
I've defined this
create-tags function on my .emacs to regenerate the tags files
(it will ask for a directory and then use that directory as root from where to
scan and place to store the
;; etags (cond ((eq system-type 'windows-nt) (setq path-to-ctags "C:/installs/gnuglobal/bin/ctags.exe"))) (cond ((eq system-type 'gnu/linux) (setq path-to-ctags "/usr/local/bin/ctags"))) (defun create-tags (dir-name) "Create tags file." (interactive "DDirectory: ") ;; (message ;; (format "%s -f %s/tags -eR %s" path-to-ctags (directory-file-name dir-name) (directory-file-name dir-name))) (shell-command (format "%s -f %s/tags -eR %s" path-to-ctags (directory-file-name dir-name) (directory-file-name dir-name))) )
With third party packages there is also support for normal ctags files and GNU Global, but I find the etags support more than convenient for my needs
No need to install anything if you have ispell on your system, just do:
:ispell-buffer to start a spell check of the current buffer (alternatives are
show above and shortcuts below) and
:ispell-change-dictionary to use another
dictionary (to check another language). If you prefer spell checking on the fly
with underlines under misspelled words use
:flyspell-mode and to see
alternatives to a misspelled word press
Alt-$ on most PCs) with the
cursor over the word.
Relative line numbers
Install the package "relative-line-numbers" and enable it globally on your config file with:
(add-hook 'prog-mode-hook 'relative-line-numbers-mode t) (add-hook 'prog-mode-hook 'line-number-mode t) (add-hook 'prog-mode-hook 'column-number-mode t)
Easymotion => Evil Ace Jump
The functionality provided by the awesome Easymotion plugin on Vim is actually integrated by default on Evil since it incorporates a package called Ace Jump that does mostly the same. It's less powerful than Easymotion (some jumps like backwards-only / forward-only / end-of-word and others are missing) and I prefer how Easymotion shows directly two chars when a jump is going to require them (instead of showing one and after pressing it, the other which is what Ace-Jump does) but the important modes (bidirectional jump to word and to char) that were the ones I was mostly using are provided.
Unlike Easymotion, jump to word asks for a letter, but that can be easily disabled
(setq ace-jump-word-mode-use-query-char nil). The author makes the case
that without asking for a char you're probably entering more key presses most of
the time. This is probably true, but when I want to jump to a random word inside
the buffer my brain-eye connection has already identified the word but I've to
stop and look/think for the first char, so in the end for me is actually faster to
get jump shortcuts to all the words without having to provide the leading
I mapped the word/line/char to
(evil-leader/set-key "e" 'evil-ace-jump-word-mode) ; ,e for Ace Jump (word) (evil-leader/set-key "l" 'evil-ace-jump-line-mode) ; ,l for Ace Jump (line) (evil-leader/set-key "x" 'evil-ace-jump-char-mode) ; ,x for Ace Jump (char)
One annoying thing that most Vim users will find in Emacs is the jumpy
scrolling. To have Emacs scroll like Vim (that is, line by line and leaving some
lines before starting to scroll) the solution is to install the package
smooth-scrolling and add this to your config:
(setq scroll-margin 5 scroll-conservatively 9999 scroll-step 1)
It's not perfect because sometimes when you're close to the start of end of the file it still jumps.
Super-easy, just install the powerline-evil package and put this in your config:
(require 'powerline) (powerline-evil-vim-color-theme) (display-time-mode t)
Syntactic checking on the fly with Flycheck
One of the best Vim plugins if you're a programmer is Syntastic that runs a
syntactic check auto detecting a huge variety of linters every time you
save. Emacs also have a similar package called "Flycheck". It is even better
because it runs in parallel while you work so you don't have to wait for it to
finish its checks like happens with Vim. Another related package is
flycheck-pos-tip that shows errors on a tooltip (if you're on GUI Emacs,
obviously) instead of the minibuffer. My full flycheck config is:
;; flycheck (package 'flycheck) (add-hook 'after-init-hook #'global-flycheck-mode) (after 'flycheck (setq flycheck-check-syntax-automatically '(save mode-enabled)) (setq flycheck-checkers (delq 'emacs-lisp-checkdoc flycheck-checkers)) (setq flycheck-checkers (delq 'html-tidy flycheck-checkers)) (setq flycheck-standard-error-navigation nil)) (global-flycheck-mode t) ;; flycheck errors on a tooltip (doesnt work on console) (when (display-graphic-p (selected-frame)) (eval-after-load 'flycheck '(custom-set-variables '(flycheck-display-errors-function #'flycheck-pos-tip-error-messages))))
j/k for browsing wrapped lines
Evil has the same problem as Vim when browsing with j/k long wrapped lines; it jumps the entire "real" line instead of the visual line. The solution is also easy:
(define-key evil-normal-state-map (kbd "j") 'evil-next-visual-line) (define-key evil-normal-state-map (kbd "k") 'evil-previous-visual-line)
escape... escapes things
One very annoying thing with Emacs is that when you are in the
M-x buffer (the
one were you call Emacs functions) you've to use
C-g to exit it. If you use
escape as most Vim users would tend to do by default you need to hit the key
like a million times (it's more like 3, but it's extremely frustrating
anyway). This code on my .emacs that I copied from davvil init.el on Github
;; esc quits (defun minibuffer-keyboard-quit () "Abort recursive edit. In Delete Selection mode, if the mark is active, just deactivate it; then it takes a second \\[keyboard-quit] to abort the minibuffer." (interactive) (if (and delete-selection-mode transient-mark-mode mark-active) (setq deactivate-mark t) (when (get-buffer "*Completions*") (delete-windows-on "*Completions*")) (abort-recursive-edit))) (define-key evil-normal-state-map [escape] 'keyboard-quit) (define-key evil-visual-state-map [escape] 'keyboard-quit) (define-key minibuffer-local-map [escape] 'minibuffer-keyboard-quit) (define-key minibuffer-local-ns-map [escape] 'minibuffer-keyboard-quit) (define-key minibuffer-local-completion-map [escape] 'minibuffer-keyboard-quit) (define-key minibuffer-local-must-match-map [escape] 'minibuffer-keyboard-quit) (define-key minibuffer-local-isearch-map [escape] 'minibuffer-keyboard-quit) (global-set-key [escape] 'evil-exit-emacs-state)
Start maximized, please
Another minor annoyance was that Emacs (GUI) didn't start maximized by default, but this is easy to fix:
(custom-set-variables '(initial-frame-alist (quote ((fullscreen . maximized))))) ;; start maximized
c-k/c-j for page down/up
One thing that surprised me considering how complete Evil is, is the lack of Vim's Control-d/Control-u for page down/up. Probably because C-u is pretty important in Emacs (it's the shortcut to give a numeric parameter to other commands, I think). I've in fact these mapped on my .vimrc to c-k/c-j (because I think they're more consistent with Vim's j/k movement keys) so that's how I mapped them in Emacs:
(define-key evil-normal-state-map (kbd "C-k") (lambda () (interactive) (evil-scroll-up nil))) (define-key evil-normal-state-map (kbd "C-j") (lambda () (interactive) (evil-scroll-down nil)))
Coding Style and spaces instead of tabs
Emacs by default do the really evil thing of using tab characters for
indentation. To do the right thing and use spaces with 4 spaces per tab:
(setq-default tab-width 4 indent-tabs-mode nil). Also, I prefer the "bsd" style
on my code on C-like languages (C, C++, Java, D...) but with 4 spaces tabs
instead of 8 so I also added:
(setq-default c-basic-offset 4 c-default-style
There is also a nice package called "dtrt-indent" that can automatically determine the indentation settings used on the file that you're currently editting and adapt Emacs's settings to them. It's great when you're editing external files not created by you or that for some reason follow different indentation rules that the ones you've in your config file.
(package 'dtrt-indent) (dtrt-indent-mode 1)
Auto-indent with the Return key
By default Emacs doesn't indent new lines until you press the TAB key. That is not good. But it can be changed easily enough to do the Vim thing, adjusting indentation on every new line automatically with:
(define-key global-map (kbd "RET") 'newline-and-indent)
Show matching paren
If you want to show the matching parenthesis, brace or bracket automatically, add
(show-paren-mode t). You can also install the Autopairs package to
automatically add the matching parens/braces/etc after adding the opening one.
I've mixed feelings about it because while very convenient (specially with Lisp!)
it can be also very annoying when you want to surround something with parents and
it adds a useless ")" after the opening one, I should use "Surround" on these
cases, but half of the time I forget it. To enable autopairs put this on your
config file after installing the package:
(require 'autopair) (autopair-global-mode)
Fill column, auto line breaking and column limit mark
To visually mark the configured fill-column for the mode (like the
option in Vim) install the package
fill-column-indicator, then you'll enable it
on every mode where you want to display it with
fci-mode (see below).
To configure auto line breaking when the line exceed 82 chars for text and markdown files, with fill indicator line:
(add-hook 'text-mode-hook (lambda () (turn-on-auto-fill) (fci-mode) (set-fill-column 82))) (add-hook 'markdown-mode-hook (lambda () (turn-on-auto-fill) (fci-mode) (set-fill-column 82)))
To set the non-auto-line limit for Python a C-mode (and D) to 94:
(add-hook 'python-mode-hook (lambda () (fci-mode) (set-fill-column 94))) (add-hook 'c-mode-hook (lambda () (fci-mode) (set-fill-column 94))) (add-hook 'd-mode-hook (lambda () (fci-mode) (set-fill-column 94)))
Silver Searcher (ag)
If you don't know it, the Silver Searcher is like Ack but a lot faster. The "ag" package will allow you to make searches with it without leaving Emacs and show the results in a quickfix-style windows where you can select results and jump to them: M-x ag RET [search] RET [directory] RET.
Spanish keyboard remaps
I use Spanish keyboards. Yes, I know, Vim is much better with an English keyboard,
but I'm 36 and have been using the Spanish layouts since I was 8, which means that
my brain is too hardwired to it. But with a few remaps I made my Vim experience
much better. These were
- (minus sign) in normal mode as
/ (to search),
escape in insert mode (I want to try the kj thing) and
:. When you
remap keys in Emacs you have to know the name of the function that the shortcut
key will point to. Fortunately using
C-h k (Control-h, release, k) will tell you
the name of the function associated with the next key you press, so getting the
name of the functions for these remaps is easy. The
: remaps were easy:
(define-key evil-normal-state-map "-" 'evil-search-forward) (define-key evil-normal-state-map " " 'evil-ex) (define-key evil-insert-state-map " " 'evil-normal-state)
Don't create backup files
I use version control and I'm a compulsive saver, so I don't need backup files. I've these disabled on Vim and I've also disabled them on Emacs:
(setq make-backup-files nil)
Don't move back the cursor one position when exiting insert mode
This is something that I hated in Vim so I had it disabled with the following lines on my .vimrc:
autocmd InsertEnter * let CursorColumnI = col('.') autocmd CursorMovedI * let CursorColumnI = col('.') autocmd InsertLeave * if col('.') != CursorColumnI | call cursor(0, col('.')+1) | endif
To get the same behaviour in Evil you just have to set one option:
(setq evil-move-cursor-back nil)
Remember the cursor position of files when reopening them
(setq save-place-file "~/.emacs.d/saveplace") (setq-default save-place t) (require 'saveplace)
Disable scroll bars
By default Emacs put a scroll bar on every window (split) which IMO is incredibly
ugly. I already have the % of my position on the file in Powerline so I don't need
any scroll bars:
Emacs GDB mode (enabled with M-x gdb RET binary_path) is pretty cool because it
create several windows in the style of typical IDE debuggers, but that's not
enabled by default, to enable it:
(setq gdb-many-windows t).
Once you're in GDB mode with the binary loaded you can change to the source code
C-x o to switch between splits or just mouse clicks, Vim-style
C-w key bindings doesn't work in gdb mode), load the source code file you want
to set breakpoints on and set a break point with M-x gud-break. Then you can run
the program with "run" (r) on the gdb window and once in the break point advance with
next (n) or step (s). Local vars and registers are show in one window, breakpoints
and the stack frame in another one.
Color Identifiers Mode and Color Delimiters
colors-identifiers-mode colorize every variable in a different color.
I've mixed feelings about it because the code looks like a fruit salad, but it
makes really easy to visually identify where variables are used. I'm using it for
now. Setup is:
(package 'color-identifiers-mode) (global-color-identifiers-mode)
Another firm step into the total fruitsalarization of your Emacs is the Rainbow Delimiters package that will color nested delimiters on a different color so you can check easily which of them are pairs without having to move the cursor over them. When you have lots of nested parenthesis this helps a lot to see the pairs without having to move the cursor over them.
(package 'rainbow-delimiters) (add-hook 'prog-mode-hook 'rainbow-delimiters-mode)
Diminish to clean clutter from the modeline
Diminish will remove the minor mode indicators from the mode line (or powerline). Example config:
(require 'diminish) (diminish 'visual-line-mode) (after 'autopair (diminish 'autopair-mode)) (after 'undo-tree (diminish 'undo-tree-mode)) (after 'auto-complete (diminish 'auto-complete-mode)) (after 'projectile (diminish 'projectile-mode)) (after 'yasnippet (diminish 'yas-minor-mode)) (after 'guide-key (diminish 'guide-key-mode)) (after 'eldoc (diminish 'eldoc-mode)) (after 'smartparens (diminish 'smartparens-mode)) (after 'company (diminish 'company-mode)) (after 'elisp-slime-nav (diminish 'elisp-slime-nav-mode)) (after 'git-gutter+ (diminish 'git-gutter+-mode)) (after 'magit (diminish 'magit-auto-revert-mode)) (after 'hs-minor-mode (diminish 'hs-minor-mode)) (after 'color-identifiers-mode (diminish 'color-identifiers-mode))
Select last yanked text
This is a pretty useful shotcut I've on my .vimrc that selects the last pasted (yanked) text:
nnoremap </leader><leader>V `[v`]
Thanks to the comment by delexi I know that the function in Emacs is called
exchange-point-and-markwhich defaults to
C-x C-x but I've remapped to
(evil-leader/set-key "V" 'exchange-point-and-mark)
Other Emacs alternatives for popular Vim plugins
- Powerline => Powerline-Evil
- Emmet => emmet-mode. I mapped "
m" to "emmet-expand-line" because the default C-j shortcut is already defined in Evil.
- Surround => evil-surround (same operators)
- Tabular.vim => M-x align-regexp RET regexp RET (with a visual selection)
- Rename => M-x dired-jump, R to rename the file, RET to reopen.
- jDaddy => I only really used it to prettify json objects, this can be done with the functions defined by James P..
- Autocomplete and company mode works much like YouCompleteMe on Vim: they give an improved completion when you're programming. I don't know the difference between both, Company is newer, I think, but the ac-dcd package for completing the D language is for Autocomplete so that's what I'm using.
- Vimdiff => M-x ediff-files or ediff-buffers. Pretty similar. Press
?for help. If you use Helm (just use it) when you're in a helm file list you can press TAB and in the actions list you can select one to marking the file for ediff; much quicker than browsing by hand to the files to compare.
- netrw/nerdtree => M-x dired (included) or M-x dired+ (installable).
Other random thoughts about Emacs, Evil and Vim
- Copy and paste with the system clipboard works without having to paste from the
"*register. It's still saved on those registers, but also in the default register so if you paste after copying from any other desktop program and then paste without specifying any register it will pull that register. Nice.
- Evil doesn't have
:put(paste below current line).
- Some windows with Evil (like
:registers) use Emacs key binding of
qto exit instead of Vim
- The toolbar is actually useful for a newbie like me. Check it. To use the
toolbar without the mouse you've the
- Paralellization is very nice to have. I love to have my syntax checked without pauses, but...
- Not everything is perfectly paralellized. For example, when the package manager is loading the information from a package on a split (and sometimes it takes its time), all the interface hangs. One nice feature of Emacs is that you can almost always cancel any long running process with Control-G.