【C/C++基础进阶系列】实战记录 -- Ubuntu 下安装 VSCode 并配置 C++ 开发环境

【C/C++基础进阶系列】实战记录 -- Ubuntu 下安装 VSCode 并配置 C++ 开发环境

【1】Ubuntu 下载安装 VSCode

Ubuntu 中 VSCode 下载路径，Documentation for Visual Studio Code

安装
sudo dpkg -i code_1.52.1-1608136922_amd64.deb
运行Vscode
code

【2】VSCode 远程调试

下载OpenSSH(setupssh-8.0p1-2.exe)，链接: 百度网盘 请输入提取码 提取码: csqa

Vscode 安装配置远程

安装远程插件，在扩展商店，输入 remote，找到 Remote Development，点击 Install

点击左下角按钮，选择打开远程配置

会弹出config文件列表，选择第一个

修改为待连接的服务器信息

Host 是名字（随便写）
HostName 是需要远程的ip
User 是远程用户名（如：root）
Port 远程端口（可选，为22默认端口时，不需要此字段）

配置修改完毕后保存，然后再次点击左下角按钮，选择连接

选择刚配置好的服务器，这里对应配置中的Host

输入密码，回车

连接成功，左下角会显示Host名称

【3】VSCode 配置 C/C++ 开发环境

前提条件，编写好 Makefile 工程，确保使用 Makefile 能够正常编译；
主要配置 launch.json 和 task.json 文件进行调试

• task.json 文件用于配置具体需要执行或调试的命令；
• launch.json 文件用于配置启动文件；
• 注意在调试时需要在 makefile 文件中配置好 debug 选项否则无法标记断点；
• 预先在需要处标记断点并按 F5 开始调试；

task.json 文件示例

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
            "label": "clean", // 任务名称
            "command": "make", // 命令
            "args": ["clean"], // 相当于make clean
            "type": "shell"
        },
        {
            "label": "build-debug",
            "command": "make",
            "args": ["all"],
            "type": "shell"
        },
        {  // 依次调试多个任务，若不配置此，则每次launch只会启动一个任务。
            "label": "build-all", 
            "dependsOn": [
            "clean",
            "build-debug"
            ]
        }
    ]
}

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": "makefile debug", // launch名称
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/debug/bin/RedisSubProj0.0.0.0", // 调试的程序位置即 makefile 生成的程序
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}", // 当前项目的路径，即用vscode打开文件夹时的位置，需要注意。
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "build-all", // 第一次开始调试的任务，见task.json
            "miDebuggerPath": "/usr/bin/gdb"
        }
    ]
}

【4】VSCode 调试

【4.1】VSCode 调试时如何添加命令行参数

在 launch.json 文件中的 configrations 项中添加 “args” 命令行参数，如下图所示

问题与解决方案

【1】VScode 通过 SSH 方式连接远程服务器失败

问题描述

连接远程服务器出现如下错误
Host key verification failed

解决方案

修改如下文件
Widnows
C:\Users\24170\.ssh\known_hosts
Linux
~/.ssh/known_hosts

删除其中对应 IP 地址的记录，此后重连时会重新生成密钥

附录

• VScode + Cmake + Linux 开发环境搭建

参见博客

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

• Cmake 相关知识点总结

参见博客

CMake简单指令：CMake学习笔记（一）

参考致谢

本博客为博主学习笔记，同时参考了网上众博主的博文以及相关专业书籍，在此表示感谢，本文若存在不足之处，请批评指正。

【1】Ubuntu16.04下配置VScode的C/C++开发环境

【2】Windows使用VSCode远程Linux（ConteOS）开发/调试C/C++（超详细）

【3】linux下使用vscode+makefile调试大型程序

【4】随手记_vscode怎样加命令行参数进行调试

【5】SSH连接时出现Host key verification failed的原因及解决方法