Win11下基于VSCode与CMake对多文件C/C++项目进行编译+运行+调试【保姆级教程】

概述: 本篇介绍一下如何在 Windows11 的 VSCode 开发环境下利用 CMake 工具进行 C/C++ 多文件项目的编译、调试、运行,其中包含 CMake 的配置【绝对保姆级】

涉及内容大致如下:

  • 工具【VSCode、MinGW、CMake】安装

  • 环境变量配置

  • VSCode插件安装

  • C++和C语言多文件项目建立

  • CMake 配置(编译器选择)

  • CMakeLists.txt 的编写

  • CMake工具栏使用【项目调试&运行】


VSCode & MinGW & CMake 安装

安装包资源链接

链接:https://pan.baidu.com/s/1w-fGJF1zAKLgAdzEK6jfVQ
提取码:jp2l


安装注意事项

  • VSCode 傻瓜式安装即可

  • MinGW 也是傻瓜式安装,只不过到了 MinGW installation Manager 窗口这一步,需要进一步勾选安装对象,一般把下面这两个勾上就好:

    • mingw32-base-bin【基础套件】
    • mingw32-gcc-g+±bin【gcc、g++编译套件】

    gcc 编译的是 C,而 g++ 编译的是 C++

    如何勾选并安装呢?比如我要安装下图的1:

    image-20240703234323795

    右击它,点击 Mark for Installation,然后这个组件就会被标记成“待安装状态”

    image-20240703234422808

    待安装状态👇

    image-20240703234613973

    然后在菜单栏中选择 Installation -> Apply Changes
    image-20240704195202352

    然后在弹出的提示对话框中选择 Apply,然后耐心等待,直至安装成功,就可以关闭对话框了

    安装好后,组件就变成如下图这样的绿色
    image-20240704195505201

  • CMake 的安装,把资源包中的 .zip 解压放到某个目录下就装好了

    CMake下载官方地址


配置环境变量

安装好上述这三者后,为了让 CMake 和 MinGW 的 bin 目录中的可执行文件(.exe)能够被全局访问,还要配置一下 MinGW 和 CMake 的环境变量

  • 本地已下载的可执行文件(各自的bin目录中)

    image.png

  • 根据 bin 目录路径配置系统环境变量 (在Windows下方搜索栏搜“环境变量”就可以配置了)image.png

  • 配置好环境变量后,在终端测试环境变量是否生效,命令如下:

    gcc -v
    g++ -v
    cmake --version
    

    如果生效,command 命令台会出现如下提示【即可以看到版本号】

    image.png

安装 VSCode 的三个插件

下面三个插件在这项任务中必不可少

打开VSCode,左侧栏找到“插件商店”,把下图圈出的这三个插件安装上
image-20240703232850727


操作详解

C++

🔷新建文件夹

新建文件夹 CMAKE-TEST,文件树如下图所示(注意此时所有的.cpp.h文件还都是空的)

<think>嗯,用户问的是在Linux系统下使用VSCode配合CMake来管理编译C/C++工程,特别是文件分布在多个路径下的情况。我需要一步步理清楚这个问题,确保回答准确且易懂。 首先,我应该确定用户的需求。他们可能有一个结构比较复杂的项目,包含多个子目录,比如源代码、头文件、资源文件分散在不同地方。使用CMake可以方便地管理这样的项目结构,而VSCode作为编辑器,需要配置好相关插件和设置来支持CMake的构建。 接下来,我得回想一下CMake的基本用法。用户可能需要知道如何编写CMakeLists.txt文件,特别是处理多个目录的情况。比如,主项目目录下的CMakeLists.txt需要添加子目录,每个子目录里也有自己的CMakeLists.txt来管理各自的源文件。这时候可能需要使用add_subdirectory命令。 然后,关于VSCode的配置。用户可能需要安装CMake Tools扩展,配置settings.json文件,指定生成器(比如Unix Makefiles或Ninja),以及设置构建目录。同时,调试配置launch.json也需要正确指向生成的可执行文件。 还有需要注意的地方,比如如何让CMake找到不同目录下的头文件,这涉及到include_directories命令。另外,如果项目中有第三方库,可能需要使用find_package或者指定库的路径。 可能用户在实际操作中会遇到路径错误、构建失败的问题,所以需要强调路径的正确写法,相对路径绝对路径的区别。此外,推荐使用out-of-source构建,即不让构建文件污染源代码目录,这样在CMake中指定构建目录为build之类的子目录。 最后,调试部分也很重要。配置好launch.json,确保调试器能找到可执行文件,并且参数设置正确。可能还需要处理多目标的情况,如果有多个可执行文件或库需要生成。 总结一下,回答的结构应该是先介绍CMake在多目录项目中的配置,再讲解VSCode的插件安装和配置,最后给出一个实际案例,并提醒常见问题和注意事项。这样用户能一步步跟着操作,同时理解每个步骤的作用。</think>好的,下面介绍在Linux系统中使用VSCode + CMake管理多目录C/C++项目的完整流程: --- ### 一、环境准备 1. 安装必要工具: ```bash sudo apt install cmake build-essential gdb ``` 2. VSCode安装插件: - `C/C++` (微软官方扩展) - `CMake` - `CMake Tools` --- ### 二、项目结构示例 ```bash myproject/ ├── CMakeLists.txt # 根目录配置文件 ├── build/ # 构建目录(建议空目录) ├── include/ # 公共头文件 │ └── utils.h ├── src/ # 主程序目录 │ ├── main.cpp │ └── CMakeLists.txt └── libs/ # 子模块库 ├── math/ │ ├── math.cpp │ └── CMakeLists.txt └── io/ ├── fileio.cpp └── CMakeLists.txt ``` --- ### 三、CMake配置要点 #### 1. 根目录 CMakeLists.txt ```cmake cmake_minimum_required(VERSION 3.10) project(MyProject) # 设置C++标准 set(CMAKE_CXX_STANDARD 17) # 包含头文件目录 include_directories(${PROJECT_SOURCE_DIR}/include) # 添加子目录 add_subdirectory(src) add_subdirectory(libs/math) add_subdirectory(libs/io) ``` #### 2. src/CMakeLists.txt ```cmake # 生成可执行文件 add_executable(${PROJECT_NAME} main.cpp ) # 链接子库 target_link_libraries(${PROJECT_NAME} MathLibrary IOLibrary ) ``` #### 3. libs/math/CMakeLists.txt ```cmake # 创建静态库 add_library(MathLibrary STATIC math.cpp ) ``` --- ### 四、VSCode配置步骤 #### 1. 配置CMake工具 按`Ctrl+Shift+P`输入: - `CMake: Select a Kit` 选择编译器(如GCC) - `CMake: Select Variant` 选择构建类型(Debug/Release) #### 2. 配置settings.json ```json { "cmake.buildDirectory": "${workspaceFolder}/build", "cmake.configureOnOpen": true, "cmake.generator": "Unix Makefiles" } ``` #### 3. 配置调试(.vscode/launch.json) ```json { "version": "0.2.0", "configurations": [ { "name": "C++ Debug", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/build/src/MyProject", "args": [], "cwd": "${workspaceFolder}", "environment": [], "externalConsole": false, "MIMode": "gdb" } ] } ``` --- ### 五、操作流程 1. 按`F1`输入`CMake: Configure`生成构建系统 2. 按`F7`编译项目 3. 按`F5`启动调试 4. 修改代码后重复2-3步 --- ### 六、常见问题处理 1. **路径问题**: - 使用`${CMAKE_CURRENT_SOURCE_DIR}`获取当前CMake文件所在路径 - 头文件包含建议用`#include "utils.h"`而不是绝对路径 2. **多目标管理**: ```cmake # 在子目录中定义独立目标 add_library(SubLib STATIC subfile.cpp) ``` 3. **第三方库链接**: ```cmake find_package(OpenCV REQUIRED) target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBS}) ``` --- 按照这个方案配置后,可以实现: - 多目录文件的自动识别 - 增量编译加速构建 - 一键调试支持 - 清晰的模块化结构管理 建议通过`CTRL+Shift+P` -> `CMake: Delete Cache and Reconfigure` 清理旧配置后重新生成。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值