在 Windows 系统下配置 VSCode + CMake + Ninja 进行 C++ 或 Qt 开发

在 Windows 系统下配置 VSCode + CMake + Ninja 进行 C++ 或 Qt 开发,是一个轻量级但功能强大的开发环境。下面我将分步骤详细说明如何搭建这个开发环境,支持纯 C++ 和 Qt 项目。


🧰 所需工具安装

1. 安装 Visual Studio Code(VSCode)

  • 下载地址:https://code.visualstudio.com/
  • 安装后建议安装以下扩展(推荐):
    • C/C++(微软官方)
    • CMake
    • CMake Tools
    • Ninja(可选)
    • Qt Tools(用于 Qt 项目)

可直接搜索安装:Extensions: Install Extension (Ctrl+Shift+X),输入关键词如 CMake, Qt, C/C++


2. 安装 CMake

  • 下载地址:https://cmake.org/download/
  • 推荐使用图形化安装程序,并勾选"Add to system PATH"选项。
  • 验证是否安装成功:
bash 复制代码
cmake --version

3. 安装 Ninja

bash 复制代码
ninja --version

4. 安装编译器

方式一:MinGW-w64(推荐轻量级)
bash 复制代码
g++ --version
gcc --version
方式二:Visual Studio Build Tools(MSVC 编译器)

5. 安装 Qt(仅用于 Qt 项目)

  • 下载在线安装器:https://www.qt.io/download
  • 推荐选择 Qt Online Installer
  • 安装时选择:
    • Qt 版本(如 Qt 6.5.x MinGW 11.2.0 64-bit)
    • Qt Creator(可选)
  • 安装完成后,确保 Qt 的 bin 路径加入系统 PATH(如 C:\Qt\Tools\mingw1120_64\bin

🛠️ 配置 VSCode + CMake + Ninja

1. 设置默认构建工具为 Ninja

打开 VSCode,按下 Ctrl+Shift+P,输入并运行:

复制代码
CMake: Configure

选择你的编译器(例如 MinGW GCC x86_64),然后会自动生成 CMakeCache.txt 文件。

你也可以手动设置默认生成器,在 .vscode/settings.json 中添加:

json 复制代码
{
  "cmake.generator": "Ninja",
  "cmake.configureOnOpen": true,
  "cmake.buildDirectory": "${workspaceFolder}/build"
}

2. 基础目录结构示例

bash 复制代码
my_project/
├── CMakeLists.txt
├── src/
│   └── main.cpp
├── build/ (CMake 生成文件)
└── .vscode/
    ├── settings.json
    ├── tasks.json
    └── launch.json

3. 示例 CMakeLists.txt(C++ 项目)

cmake 复制代码
cmake_minimum_required(VERSION 3.16)
project(MyApp)

set(CMAKE_CXX_STANDARD 20)

add_executable(myapp src/main.cpp)

4. 示例 CMakeLists.txt(Qt 项目)

cmake 复制代码
cmake_minimum_required(VERSION 3.16)
project(QtApp)

set(CMAKE_INCLUDE_CURRENT_DIR ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUI ON)

find_package(Qt6 COMPONENTS Widgets REQUIRED)

add_executable(QtApp
    src/main.cpp
    src/mainwindow.cpp
    src/mainwindow.h
    src/mainwindow.ui
)

target_link_libraries(QtApp PRIVATE Qt6::Widgets)

5. 配置调试器(launch.json)

json 复制代码
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "GDB Debug",
      "type": "cppdbg",
      "request": "launch",
      "program": "${workspaceFolder}/build/myapp.exe",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [],
      "externalConsole": true,
      "MIMode": "gdb",
      "miDebuggerPath": "C:\\msys64\\mingw64\\bin\\gdb.exe"
    }
  ]
}

6. 配置任务(tasks.json)

json 复制代码
{
  "tasks": [
    {
      "label": "CMake Configure",
      "type": "shell",
      "command": "cmake",
      "args": ["-B", "${workspaceFolder}/build", "-G", "Ninja"],
      "group": { "kind": "build", "isDefault": true },
      "problemMatcher": ["$cmake"]
    },
    {
      "label": "CMake Build",
      "type": "shell",
      "command": "cmake",
      "args": ["--build", "${workspaceFolder}/build"],
      "group": { "kind": "build", "isDefault": true },
      "problemMatcher": ["$cmake"]
    }
  ],
  "version": "2.0.0"
}

✅ 使用流程总结

  1. 打开项目根目录(含 CMakeLists.txt);
  2. VSCode 会自动运行 CMake: Configure(根据 .vscode/settings.json);
  3. Ctrl+Shift+B 构建项目;
  4. F5 启动调试;
  5. 修改代码后重新构建即可运行新版本;

🧪 测试一个 Qt 项目(main.cpp)

cpp 复制代码
#include <QApplication>
#include <QLabel>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QLabel label("Hello from Qt!");
    label.show();
    return app.exec();
}

确保你的 mainwindow.ui.h.cpp 文件也存在并被正确引用。


📝 小贴士

  • 如果使用 MSVC 编译器,请确保从 VS 自带终端启动 VSCode;
  • Qt 项目需要确保所有依赖库都在 PATH 或链接正确;
  • 可以使用 qmake 或 Qt Creator 作为替代方案,但 VSCode 更加轻便灵活;
  • 对于大型项目,可以结合 conanvcpkg 管理第三方库。
相关推荐
2301_803554523 小时前
c++中类的前置声明
java·开发语言·c++
马里马里奥-7 小时前
在Windows系统部署本地智能问答系统:基于百度云API完整教程
windows·云计算·百度云
LyaJpunov9 天前
深入理解 C++ volatile 与 atomic:五大用法解析 + 六大高频考点
c++·面试·volatile·atomic
小灰灰搞电子9 天前
Qt PyQt与PySide技术-C++库的Python绑定
c++·qt·pyqt
曹勖之9 天前
simuilink和ROS2数据联通,Run后一直卡在Initializting
windows·matlab·simulink·ros2
成遇9 天前
在Vscode中安装Sass并配置
vscode·rust·sass
时空自由民.9 天前
C++ 不同线程之间传值
开发语言·c++·算法
浩浩测试一下9 天前
渗透测试指南(CS&&MSF):Windows 与 Linux 系统中的日志与文件痕迹清理
linux·运维·windows·安全·web安全·网络安全·系统安全
驱动小百科9 天前
如何在Windows上安装.NET Framework 详细教程分享
windows·.net·.net framework·.net安装·.net下载
Ray_19979 天前
C++二级指针的用法指向指针的指针(多级间接寻址)
开发语言·jvm·c++