An excerpt from the repository, fetched Nov 13, 2026.
Read the project’s introduction
,
/ \,,_ .'|
,{{| /}}}}/_.' _____________________________________________
}}}}` '{{' '. / \
{{{{{ _ ;, \ / Ladies and Gentlemen, \
,}}}}}} /o`\ ` ;) | |
{{{{{{ / ( | this is ... |
}}}}}} | \ | |
{{{{{{{{ \ \ | |
}}}}}}}}} '.__ _ | | _____ __ __ _ |
{{{{{{{{ /`._ (_\ / | / ___/__ ______ / /_____ ______/ /_(_)____ |
}}}}}}' | //___/ --=: \__ \/ / / / __ \/ __/ __ `/ ___/ __/ / ___/ |
jgs `{{{{` | '--' | ___/ / /_/ / / / / /_/ /_/ (__ ) /_/ / /__ |
}}}` | /____/\__, /_/ /_/\__/\__,_/____/\__/_/\___/ |
| /____/ |
| /
\_____________________________________________/
Deprecation note
Introduction
Installation
3.1. Requirements
3.2. Installing syntastic with Pathogen
Recommended settings
FAQ
5.1. I installed syntastic but it isn't reporting any errors...
5.2. Syntastic supports several checkers for my filetype, how do I tell it which one(s) to use?
5.3. How can I run checkers for "foreign" filetypes against the current file?
5.4. I have enabled multiple checkers for the current filetype. How can I display all errors from all checkers together?
5.5. How can I pass additional arguments to a checker?
5.6. I run a checker and the location list is not updated...
5.6. I run:lopen or :lwindow and the error window is empty...
5.7. How can I jump between the different errors without using the location list at the bottom of the window?
5.8. The error window is closed automatically when I :quit the current buffer but not when I :bdelete it?
5.9. My favourite checker needs to load a configuration file from the project's root rather than the current directory...
5.10. What is the difference between syntax checkers and style checkers?
5.11. How can I check scripts written for different versions of Python?
5.12. How can I check scripts written for different versions of Ruby?
5.13. The perl checker has stopped working...
5.14. What happened to the rustc checker?
5.15. What happened to the tsc checker?
5.16. What happened to the xcrun checker?
5.17. What happened to the valac checker?
5.18. What happened to the Julia lint checker?
Resources
1. Deprecation note
This project is no longer maintained. If you need a syntax checking plugin
for Vim you might be interested in Syntastic's spiritual succesor,
ALE. Although it shares no code with syntastic and it takes a very
different approach to design, ALE can be considered a natural evolution
of syntastic in terms of goals and functionality. Check it out, you probably
won't be disappointed.
2. Introduction
Syntastic is a syntax checking plugin for Vim created by
Martin Grenfell. It runs files through external syntax checkers
and displays any resulting errors to the user. This can be done on demand, or
automatically as files are saved. If syntax errors are detected, the user is
notified and is happy because they didn't have to compile their code or execute
their script to find them.
At the time of this writing, syntastic has checking plugins for ACPI
Source Language, ActionScript, Ada, Ansible configurations, API Blueprint,
AppleScript, AsciiDoc, Assembly languages, BEMHTML, Bro, Bourne shell, C, C++,
C#, Cabal, Chef, CMake, CoffeeScript, Coco, Coq, CSS, Cucumber, CUDA, D, Dart,
DocBook, Dockerfile, Dust, Elixir, Erlang, eRuby, Fortran, Gentoo metadata,
GLSL, Go, Haml, Haskell, Haxe, Handlebars, HSS, HTML, Java, JavaScript, JSON,
JSX, LESS, Lex, Limbo, LISP, LLVM intermediate language, Lua, Markdown,
MATLAB, Mercury, NASM, Nix, Objective-C, Objective-C++, OCaml, Perl, Perl
POD, PHP, gettext Portable Object, Raku, OS X and iOS property lists, Pug
(formerly Jade), Puppet, Python, QML, R, Racket, RDF TriG, RDF Turtle, Relax
NG, reStructuredText, RPM spec, Ruby, SASS/SCSS, Scala, Slim, SML, Solidity,
Sphinx, SQL, Stylus, Tcl, TeX, Texinfo, Twig, TypeScript, Verilog, VHDL, Vim
help, VimL, Vue.js, xHtml, XML, XSLT, XQuery, YACC, YAML, YANG data models,
YARA rules, z80, Zope page templates, and Zsh. See the manual for
details about the corresponding supported checkers (:help syntastic-checkers
in Vim).
A number of third-party Vim plugins also provide checkers for syntastic, for
example: merlin, omnisharp-vim, rust.vim,
syntastic-extras, syntastic-more, tsuquyomi,
vim-crystal, vim-eastwood, and vim-swift.
Below is a screenshot showing the methods that Syntastic uses to display syntax
errors. Note that, in practise, you will only have a subset of these methods
enabled.
Errors are loaded into the location list for the corresponding window.
When the cursor is on a line containing an error, the error message is echoed in the command window.
Signs are placed beside lines with errors - note that warnings are displayed in a different color.
There is a configurable statusline flag you can include in your statusline config.
Hover the mouse over a line containing an error and the error message is displayed as a balloon.
(not shown) Highlighting errors with syntax highlighting. Erroneous parts of lines can be highlighted.
3. Installation
3.1. Requirements
Syntastic itself has rather relaxed requirements: it doesn't have any external
dependencies, and it needs a version of Vim compiled with a few common
features: autocmd, eval, file_in_path, modify_fname, quickfix,
reltime, statusline, and user_commands. Not all possible combinations of
f
Read the full README on GitHub