C++ development environment setup in Spacemacs

spacemacs-cpp.md

Table of Contents

• 1. Setup Cpp/C Development Environment in Spacemacs
  • 1.1. 1. Add c/c++ layer
    • 1.1.1. Notes
  • 1.2. 2. Makefile and Source code in the same directory
  • 1.3. 3. Makefile in different directory
    • 1.3.1. Notes
  • 1.4. 4. Clang Complete
    • 1.4.1. Usage
  • 1.5. 5. Debug
    • 1.5.1. Compile source files with -g flag
    • 1.5.2. SPC : -> gdb invoke gdb inside Spacemacs
  • 1.6. Todo
    • 1.6.1. Try rtags for better code navigation.

Setup Cpp/C Development Environment in Spacemacs

Based on Eivind Fonn's tutorial [https://www.youtube.com/watch?v=OjbkCEkboA8]

1. Add c/c++ layer

Simply add this (c-c++ :variables c-c++-enable-clang-support t) in dotspacemacs-configuration-layers, like this:

...
dotspacemacs-configuration-layers
'( ...
  (c-c++ :variables c-c++-enable-clang-support t)
  ...
  )
...

Notes

This configuration will enable clang support, so you have to guarantee clang has been installed.

2. Makefile and Source code in the same directory

This is the simplest situation, that you can open any source code file, then type SPC c c for compilation. SPC c C is for specifying compilation command, sometimes need this for enabling debug mode.

3. Makefile in different directory

In this situation we need to specify the location of Makefile. .dir-locals.el file is needed for this purpose. .dir-locals.el should be placed in project root. The file content looks like this:

((c++-mode (helm-make-build-dir . "build/")))

Notes

1. The path build/ is relative to project root directory.

2. Emacs will ask if the variable helm-make-build-dir is safe.

   Put the configuration in .spacemacs to prevent this.

   (put 'helm-make-build-dir 'safe-local-variable 'stringp)
   

4. Clang Complete

If the project depends on third party libraries or header files in special locations, clang will not figure out how to analyze source codes and provide auto-complete tips. We need the .clang_complete file to specify the compilation flags. That file can be generated by cc_args.py, which is a tool provided by clang-complete project. Otherwise, The simplest way to install cc_args.py, I think is move the file to /usr/local/bin/.

Usage

The video by Eivind Fonn demonstrates how to use cc_args.py with cmake. [28:00 - 29:40].

CXX="cc_args.py g++" cmake ...#other flags

I find the codes below can work with Makefile and make system directly, but it will invoke the compilation process. And the compilation process always been interrupted by errors, though it can generate the .clang_complete file. This may cause incomplete compilation flags in .clang_complete.

CXX="cc_args.py g++" make all

1. Turn off Warnings about unused variables

   Add -Wno-unused-parameter to .clang_complete file.

5. Debug

Compile source files with -g flag

So the target executable file will contain debug information.

SPC : -> gdb invoke gdb inside Spacemacs

The GUD interface in Spacemacs has a problem, which cause the current line indicator disappeared.

Rtags for code navigation

https://github.com/lujun9972/emacs-document/blob/master/emacs-common/%E5%9C%A8spacemacs%E4%B8%AD%E4%BD%BF%E7%94%A8rtags.org

Thank you so much!
This is very helpful and straight forward

Thanks!

Thanks, this is awesome!

Thanks!

Is there a option for executing(that excludes terminal in emacs), something like execute in Rust layer?

Hello, I have some problem with directory local variables. I want to configure spacemacs for C/C++ projects.
I'm following tutorials from C/C++ in Spacemacs and C++ dev env setup. Both of this tutorials suggests to
create file in project's root directory .dir-locals.el with following code:

((c++-mode (helm-make-build-dir . "build/")))

And to permanenly mark these value as safe I've added:

(put 'helm-make-build-dir 'safe-local-variable 'stringp)

to my ~/.spacemacs config inside dotspacemacs/user-config

My test project directory now looks as following:

project
│ .dir-locals.el
│ main.cpp
└───build
│   │   Makefile
│   │   cmake_install.cmake
│   │   CMakeCache.txt
│   └───CMakeFiles

But, when I'm try to compile (SPC-c-c) I've an error: Wrong type argument: arrayp, nil.
I'm running on:

• Manjaro Linux 18.0.2 (Kernel: 4.19.20-1)
• GNU Emacs 26.1
• Spacemacs 0.200.13@26.1

I have the same problem @NovaSurfer had.
Also wen I configure it like shown in the video by Elvin Fonn https://www.youtube.com/watch?v=OjbkCEkboA8&t=262s

Spacemacs 0.300.0@26.2

@ctrlPain, try to create git repository first, inside this folder

Thanks dude, that solved it.

Hello, I'm new to spacemacs and I don't understand how to us the cc_args.py file that was described in the video. Can anyone give me a step by step explanation or guide on how to install/download the file and how to use it ? I'm sorry if it is too much but I really want to use spacemacs because it looks fun.