Linux上VScode + cmake + gcc开发环境搭建

下载、安装

# cmake gcc 安装都很简单
# 只需要注意安装的版本就可以了
# 因为要做px4开发，我gcc的安装版本是 5.4.0
sudo apt-get install cmake
sudo apt-get install gcc

# vscode 安装过程有些繁琐
# 添加源
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg
sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'

# 更新安装
sudo apt-get update
sudo apt-get install code

vscode安装插件

vscode安装如下两个插件就够了：
分别在扩展商店中搜索c/c++和cmake，安装名字为c/c++和cmake的插件（只安装这两个即可，有一个cmake tools插件，我认为不太好用，进入vscode工作区时它会自动执行cmakelist，但是生成的文件和我直接执行cmake指令需要的文件不太相同，插件又无法修改执行的指令，索性就不用这个插件了）

• C/C++
• cmake

cmake文件结构

我经常用的文件工程结构如下：

-webbench：为工程文件夹

• src：中存每个模块的源码
• include：中存放头文件
• debian：存放copyright等
• build：在此文件夹中构建工程，不污染源文件
• bin：生成的可执行文件在这个文件夹
• build.sh：cmake的脚本

上面一个CMakeLists.txt的内容如下：

project(webbench)
cmake_minimum_required(VERSION 2.8)

#	创建debug版本
set(CMAKE_BUILD_TYPE "Debug")

#   add module directory
add_subdirectory(src)

下面（src中）的CMakeLists.txt内容如下：

include_directories(${PROJECT_SOURCE_DIR}/include)

aux_source_directory(. SRC_LIST)

add_executable(webbench ${SRC_LIST})

set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

cmake的命令的具体含义可以查看下面这个帖子
cmake简单教程

build.sh内容如下：

#!bin/bash
# Program
#   build a c project
# History
# 2019/05/22        Lius        First release

test -e build/ || mkdir build
echo "mkdir build/"

test -e bin/ || mkdir bin
echo "mkdir bin/"

cd build/
cmake ..
make

vscode修改json文件

用vscode打开工程文件夹！打开工程文件夹！打开工程文件夹！
重要的事情说三遍。
用vscode打开单个文件是无法编译的，所以需要在工程文件夹上右键，用vscode打开。

• 打开工程文件夹
• shift + ctrl + b 按照顺序执行，会创建tasks.json文件
• F5 会创建 launch.json 文件
• 修改上述两个文件（如果都没创建也没关系，可以自己在工程文件夹下建立.vscode文件夹，里面存放tasks.json 和 launch.json文件）

task.json内容修改成下面

{
    "tasks": [
        {
            "type": "shell",
            "label": "gcc build active file",
            //	执行工程文件夹下面的build.sh脚本
            "command": "sh ${workspaceFolder}/build.sh",
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ],
    "version": "2.0.0"
}

launch.json内容修改成下面

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "gcc build and debug active file",
            "type": "cppdbg",
            "request": "launch",
            //	去bin文件夹找可执行文件
            "program": "${workspaceFolder}/bin/${fileBasenameNoExtension}",
            //	每次执行命令行参数在argc中输入
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "gcc build active file",
            "miDebuggerPath": "/usr/bin/gdb"
        }
    ]
}

编译、调试的过程

• 添加、删除文件夹需要修改cmake中的指令
• 之后在vscode中 ctrl + shift + B编译（tasks.json 调用build.sh脚本编译）
• F5 运行调试 （launch.json调用 bin 中的可执行文件进行调试）

所以vscode的优点：

• 编写程序时代码/关键词补全
• 调试时比gdb简单
• 查看代码方便：声明、定义之间的跳转

其本质还是使用shell脚本编译工程文件；debug时是用gdb调试bin中生成的可执行文件；