Lint C and C++ source files using gcc / g++







This package provides the following services:

This package consumes the following services:


Build Status apm

Warning: This plugin has been merged with the original linter-gcc and will no longer be updated. Please use that version instead.

This plugin provides an interface to gcc/g++ for linting and works with either Linter or atom-ide-ui (through atom-ide-diagnostics). You will need to manually install one or the other before it will function properly.

Used with files with grammar "C", "C++" and "C++14".

Includes linting on-the-fly, though it is only partially tested. Please open an issue if you encounter any problems.

For instructions on using this with Windows Subsystem for Linux (WSL), checkout the Wiki.

Important info for Mac OSX users!

If you have XCode installed on OSX, the gcc/g++ commands will both link to clang. This can cause issues with the -fmax-errors option used by linter-gcc2, which isn't recognised by clang. To properly install GCC, you need to install it with Homebrew (instructions here). You will likely also need to add the flag -fsyntax-only to your C Flags or C++ Flags.

Linter in action!

linter-gcc screenshot

Using CMake compile settings

linter-gcc2 can take compile settings from CMake. For example:

git clone
cd gtf2tab
mkdir build
cd build

Running cmake with the -DCMAKE_EXPORT_COMPILE_COMMANDS flag generates a compile_commands.json file which linter-gcc2 can get the compile settings from. Then you simply open the project in Atom, and enter ./build/compile_commands.json in the Compile Commands File setting of linter-gcc2. Note that if you supply a valid compile_commands.json file, your include paths and compile flags configuration settings (described below) are ignored.

Unfortunately, CMake does not typically compile header files so the compile_commands.json file does not include entries for these files. To add them you can use a tool like compdb.

compdb -p ./ list > compile_commands.json

File/Project-Specific settings

Assuming you have the a file called sample.cpp open, linter-gcc2 performs the following actions:

  1. Looks for file called sample.cpp.gcc-flags.json in the same directory as your source file (file-specific settings)
  2. Looks for a file called .gcc-flags.json in every subdirectory from the current up to your project root (subdirectory/project-specific settings)
  3. If no .gcc-flags.json is found, the settings in your configuration page are used.

The package takes its settings from the first configuration file that is found.

You can specify your settings in .gcc-flags.json, at any level (file/subdirectory/project) using the following syntax:

  "execPath": "/usr/bin/g++",
  "gccDefaultCFlags": "-Wall",
  "gccDefaultCppFlags": "-Wall -std=c++11",
  "gccErrorLimit": 15,
  "gccIncludePaths": ".,./include,./path",
  "gccSuppressWarnings": true

Note that the include paths need to be separated by commas. If this file is present, it will replace the settings you specified in the settings window. Relative paths (starting with . or ..) are expanded with respect to the root folder. Both execPath and gccIncludePaths are expanded.

Paths are expanded relative to the project that contains the file being linted. The package limits its search to 30 levels when looking for a configuration file. Within each project, you may have as many file/directory-specific configuration files as you wish.

Usage notes:

Plugin installation

Press ctrl and ',' or cmd and ',' , click on 'Packages', search 'linter gcc', or:

$ apm install linter-gcc2

Reporting Issues

Please read the Wiki before reporting any issues.