This is a quick note on how to resolve the bug of taglist for Vim running on iTerm2.

When you use vim with taglist on iTerm2, with the default iTerm2 settings, you may have the following wired bug:

  1. run :TlistToggle first time, the side window opens correctly, as shown below

  1. run :TlistToggle second time, the window is closed correctly;

  2. run :TlistToggle third time, the window is supposed to be reopened. However, we will see garbled texts, as below.

And the same bug reported on https://github.com/int3/vim-taglist-plus/issues/4 and https://apple.stackexchange.com/questions/51748/taglist-in-iterm2/324572#324572 Strangely it’s never been solved.

The bug is caused by a feature provided by iTerm2. Here is the solution: go to iTerm2

Preferences -> Profiles -> Terminal -> uncheck "Disable session-initiated window resizing".