224

I am getting 'trailing whitespace' errors trying to commit some files in Git.

I want to remove these trailing whitespace characters automatically right before I save Python files.

Can you configure Vim to do this? If so, how?

3

14 Answers 14

224

I found the answer here.

Adding the following to my .vimrc file did the trick:

autocmd BufWritePre *.py :%s/\s\+$//e

The e flag at the end means that the command doesn't issue an error message if the search pattern fails. See :h :s_flags for more.

12
  • 1
    Interesting! Trailing white space is a battle at work. I loathe it, others don't understand why. We use as much vi as vim (I use vim; they don't because they'd have to install it). I have a program I call stb to Strip Trailing Blanks and I use that as a filter; works in vi too. This is better. Jan 15, 2009 at 14:06
  • 22
    This changes cursor position on each save. Is is possible to avoid it?
    – stepancheg
    Oct 24, 2009 at 15:59
  • 6
    Since this is the de facto answer for this question maybe it should be updated to maintain cursor position.
    – Edu Felipe
    May 4, 2011 at 14:26
  • 3
    This will also delete trailing spaces in multi-line strings, which may not be desired in some cases. But I guess there is no easy way to avoid this?
    – luator
    Aug 11, 2015 at 8:58
  • 4
    Maybe you could explicit that the e at the end means, if we did not find the pattern, vi does not consider the substitute command as failed
    – LLenain
    Dec 1, 2016 at 12:46
183

Compilation of above plus saving cursor position:

function! <SID>StripTrailingWhitespaces()
  if !&binary && &filetype != 'diff'
    let l:save = winsaveview()
    keeppatterns %s/\s\+$//e
    call winrestview(l:save)
  endif
endfun

autocmd FileType c,cpp,java,php,ruby,python autocmd BufWritePre <buffer> :call <SID>StripTrailingWhitespaces()

If you want to apply this on save to any file, leave out the second autocmd and use a wildcard *:

autocmd BufWritePre,FileWritePre,FileAppendPre,FilterWritePre *
  \ :call <SID>StripTrailingWhitespaces()
12
  • 9
    You could better your function by also saving the last search and restoring it. let _s=@/ let @/=_s
    – xApple
    Jun 21, 2011 at 14:58
  • 4
    I removed the autocmd FileType c,cpp,java,php,ruby,python part to make it apply to all files.
    – swt83
    Aug 29, 2013 at 18:50
  • 10
    @xApple: Inside functions, saving and restoring the last search is not necessary - leaving the function context will take care of that.
    – Tobias
    Feb 25, 2014 at 13:16
  • 3
    @swt83 you need to also replace <buffer> with * if you want it to work on all files
    – cadlac
    May 19, 2014 at 1:32
  • 4
    If you prefix the substitute command w/ keepp, it will not alter your search history, i.e. keepp %s/\s\+$//e
    – jeberle
    Jul 23, 2016 at 4:55
70

I also usually have a :

match Todo /\s\+$/

in my .vimrc file, so that end of line whitespace are hilighted.

Todo being a syntax hilighting group-name that is used for hilighting keywords like TODO, FIXME or XXX. It has an annoyingly ugly yellowish background color, and I find it's the best to hilight things you don't want in your code :-)

4
  • 7
    Or you can set list and set listchars+=trail:.
    – Oli
    Dec 11, 2008 at 7:17
  • Excellent - it's the perfect middle ground between automatically removing trailing whitespace (even when I may not be aware of it, or when it's someone else's code that I'm just happening to work in the same file with), to not doing anything about it. Thanks. Jun 22, 2011 at 7:13
  • 2
    unfortunately, my favorite color scheme zenburn doens't highlight
    – Peter Long
    Jul 22, 2011 at 8:14
  • @PeterLong, doesn't work in railscasts theme either. Check it with :hi Todo. So I perused :hi <Tab> and :help hi. I considered Cursor and Error, but I think I'll try match VisualNOS /\s\+$/ . I might combine this with some of the autocmds from other answers here. Jul 26, 2014 at 22:16
56

I both highlight existing trailing whitespace and also strip trailing whitespace.

I configure my editor (vim) to show white space at the end, e.g.

enter image description here

with this at the bottom of my .vimrc:

highlight ExtraWhitespace ctermbg=red guibg=red
match ExtraWhitespace /\s\+$/
autocmd BufWinEnter * match ExtraWhitespace /\s\+$/
autocmd InsertEnter * match ExtraWhitespace /\s\+\%#\@<!$/
autocmd InsertLeave * match ExtraWhitespace /\s\+$/
autocmd BufWinLeave * call clearmatches()

and I 'auto-strip' it from files when saving them, in my case *.rb for ruby files, again in my ~/.vimrc

function! TrimWhiteSpace()
    %s/\s\+$//e
endfunction
autocmd BufWritePre     *.rb :call TrimWhiteSpace()
1
  • Great! Thanks!, I specially like the function.
    – EHM
    Sep 15, 2020 at 20:49
13

Here's a way to filter by more than one FileType.

autocmd FileType c,cpp,python,ruby,java autocmd BufWritePre <buffer> :%s/\s\+$//e
1
  • Every File: autocmd FileType * autocmd BufWritePre <buffer> :%s/\s\+$//e
    – JREAM
    Mar 9, 2017 at 23:19
10

I saw this solution in a comment at VIM Wikia - Remove unwanted spaces

I really liked it. Adds a . on the unwanted white spaces.

enter image description here

Put this in your .vimrc

" Removes trailing spaces
function TrimWhiteSpace()
  %s/\s*$//
  ''
endfunction

set list listchars=trail:.,extends:>
autocmd FileWritePre * call TrimWhiteSpace()
autocmd FileAppendPre * call TrimWhiteSpace()
autocmd FilterWritePre * call TrimWhiteSpace()
autocmd BufWritePre * call TrimWhiteSpace()
0
8

Copied and pasted from http://blog.kamil.dworakowski.name/2009/09/unobtrusive-highlighting-of-trailing.html (the link no longer works, but the bit you need is below)

"This has the advantage of not highlighting each space you type at the end of the line, only when you open a file or leave insert mode. Very neat."

highlight ExtraWhitespace ctermbg=red guibg=red
au ColorScheme * highlight ExtraWhitespace guibg=red
au BufEnter * match ExtraWhitespace /\s\+$/
au InsertEnter * match ExtraWhitespace /\s\+\%#\@<!$/
au InsertLeave * match ExtraWhiteSpace /\s\+$/
2
  • 1
    The blog link seems to have died.
    – Tobias
    Feb 25, 2014 at 13:18
  • The same solution is found at the this link under "Using the match command". Aug 2, 2019 at 9:07
5

This is how I'm doing it. I can't remember where I stole it from tbh.

autocmd BufWritePre * :call <SID>StripWhite()
fun! <SID>StripWhite()
    %s/[ \t]\+$//ge
    %s!^\( \+\)\t!\=StrRepeat("\t", 1 + strlen(submatch(1)) / 8)!ge
endfun
5
  • 2
    Hum, that's pretty dangerous to do it on "*" if you eventually open up binary files, they may end up in a pretty bad shape.
    – mat
    Dec 18, 2008 at 20:45
  • Yeah probably not the smartest, then again I don't use vim for a hex editor either. That won't execute unless you save.
    – gregf
    Apr 1, 2009 at 20:43
  • I think this beats the alternative of listing every single file type that you might work on, no? I work on rb, php, cs, html, sass, css, js, coffee, xml, xslt, pl, etc, etc, etc... Is there a happy medium? Jun 18, 2011 at 1:27
  • 4
    Unless you're writing to binary files in vim this probably won't ever be a issue.
    – gregf
    Jun 20, 2011 at 21:47
  • It appears in the first %s the global (g) flag is as useless as a space at EOL :-)
    – Jens
    Feb 6, 2013 at 15:41
3

A solution which simply strips trailing whitespace from the file is not acceptable in all circumstances. It will work in a project which has had this policy from the start, and so there are no such whitespace that you did not just add yourself in your upcoming commit.

Suppose you wish merely not to add new instances of trailing whitespace, without affecting existing whitespace in lines that you didn't edit, in order to keep your commit free of changes which are irrelevant to your work.

In that case, with git, you can can use a script like this:

#!/bin/sh

set -e # bail on errors

git stash save commit-cleanup
git stash show -p | sed '/^\+/s/ *$//' | git apply
git stash drop

That is to say, we stash the changes, and then filter all the + lines in the diff to remove their trailing whitespace as we re-apply the change to the working directory. If this command pipe is successful, we drop the stash.

2

For people who want to run it for specific file types (FileTypes are not always reliable):

autocmd BufWritePre *.c,*.cpp,*.cc,*.h,*.hpp,*.py,*.m,*.mm :%s/\s\+$//e

Or with vim7:

autocmd BufWritePre *.{c,cpp,cc,h,hpp,py,m,mm} :%s/\s\+$//e
1

The other approaches here somehow didn't work for me in MacVim when used in the .vimrc file. So here's one that does and highlights trailing spaces:

set encoding=utf-8
set listchars=trail:·
set list
2
1

If you trim whitespace, you should only do it on files that are already clean. "When in Rome...". This is good etiquette when working on codebases where spurious changes are unwelcome.

This function detects trailing whitespace and turns on trimming only if it was already clean.

The credit for this idea goes to a gem of a comment here: https://github.com/atom/whitespace/issues/10 (longest bug ticket comment stream ever)

autocmd BufNewFile,BufRead *.test call KarlDetectWhitespace()

fun! KarlDetectWhitespace()
python << endpython
import vim
nr_unclean = 0
for line in vim.current.buffer:
    if line.rstrip() != line:
        nr_unclean += 1

print "Unclean Lines: %d" % nr_unclean
print "Name: %s" % vim.current.buffer.name
cmd = "autocmd BufWritePre <buffer> call KarlStripTrailingWhitespace()"
if nr_unclean == 0:
    print "Enabling Whitespace Trimming on Save"
    vim.command(cmd)
else:
    print "Whitespace Trimming Disabled"
endpython
endfun

fun! KarlStripTrailingWhitespace()
    let l = line(".")
    let c = col(".")
    %s/\s\+$//e
    call cursor(l, c)
endfun
1
  • You could also keep search register let _s=@/ and restore it at the end ` let @/=_s` .In this case we are using black hole register Nov 23, 2016 at 13:02
1
autocmd BufWritePre *.py execute 'norm m`' | %s/\s\+$//e | norm g``

This will keep the cursor in the same position as it was just before saving

0

autocmd BufWritePre * :%s/\s\+$//<CR>:let @/=''<CR>

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.