讲师中心 微信公众号
AI工具推荐 视频效率加速

CMake Windows下编译第一个项目教程

轻萱大大_3005

轻萱大大_3005

发布时间:2026-08-07 14:42:23

|

713人浏览过

|

来源于php中文网

原创

CMake安装正常但configure失败,主因是编译器未被识别:MinGW的bin目录未加入PATH、Kit选择错误或生成器不匹配;需验证g++ --version、手动选MinGW Kit、指定-G "MinGW Makefiles"并确保project()声明LANGUAGES CXX。

cmake windows下编译第一个项目教程

cmake --version 能跑,但 configure 失败

说明 CMake 安装没问题,但构建失败通常卡在编译器没被识别。Windows 下最常见的是:gcc 或 g++ 没加进系统 PATH,或者 CMake 没选对 Kit。

验证方式:打开 CMD,执行 g++ --version。如果报“不是内部或外部命令”,就说明 MinGW 的 bin 目录没进环境变量——比如你解压到 D:\MinGW,那必须把 D:\MinGW\bin 加进系统 PATH,重启 CMD 再试。

  • VS Code 用户请按 Ctrl+Shift+P → 输入 CMake: Select a Kit,手动选带 MinGW 字样的项(如 GNU 13.2.0 x86_64-w64-mingw32)
  • 命令行用户可显式指定生成器:cmake -G "MinGW Makefiles" ..,注意路径是上层目录(即 CMakeLists.txt 所在处)
  • 别用 Visual Studio 17 2022 生成器配 MinGW,会直接报错 Generator not supported

CMakeLists.txt 写完却提示 SRC_LIST 未定义

这是新手高频错误:用了变量但没提前 set(),或者拼写不一致。比如写了 add_executable(hello ${SRC_LIST}),但前面漏了 set(SRC_LIST main.cpp),CMake 就当 ${SRC_LIST} 是空字符串,最终变成 add_executable(hello ),语法错误。

更隐蔽的是大小写:Windows 文件系统不区分大小写,但 CMake 变量名严格区分。写成 set(src_list main.cpp) 后再用 ${SRC_LIST},照样报错。

C++ Code Review Master
C++ Code Review Master

组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载
  • 推荐绕过变量,直接写死源文件:add_executable(hello main.cpp),简单项目够用
  • 若要用变量,确保 set() 在 add_executable() 前,且名称完全一致(建议全大写 + 下划线,如 SOURCES)
  • project() 必须放在 cmake_minimum_required() 之后、任何 add_executable() 之前,否则 MESSAGE() 等指令可能取不到 PROJECT_SOURCE_DIR

build 目录里没生成 .exe,只有 .o 和 Makefile

这是生成器和构建命令没配对导致的。用 MinGW Makefiles 生成器时,CMake 只生成 Makefile,不会自动调用 mingw32-make 编译;而 VS Code 的 CMake: Build 命令默认会触发构建,但命令行下必须手动执行。

典型流程是两步:先 cmake ..(在 build 目录内运行,生成构建文件),再 mingw32-make(或 make,取决于你的 MinGW 安装命名)。

  • 确认 mingw32-make.exe 在 PATH 中(有些 MinGW 版本叫 mingw-make.exe 或直接是 make.exe)
  • 如果执行 mingw32-make 报错 no targets specified,说明 CMakeLists.txt 里没定义 add_executable(),或 project() 缺失导致后续指令失效
  • VS Code 用户检查状态栏右下角是否显示 “Ready” —— 如果卡在 “Configuring…” 或 “Building…”,说明前一步 configure 失败,得回退查日志

main.cpp 编译报错 “iostream: No such file or directory”

这不是代码问题,是 CMake 没声明语言标准或编译器类型。CMake 默认按 C 语言处理,#include <iostream> 属于 C++,必须明确告诉它这是 C++ 项目。

关键就两行:project(XXX LANGUAGES CXX) 和 set(CMAKE_CXX_STANDARD 17)。缺前者,CMake 可能用 gcc 而非 g++ 编译;缺后者,std::cout 在旧标准下可能不可用。

  • 不要只写 project(XXX),后面必须跟 LANGUAGES CXX(C++11 及以上)或 LANGUAGES C(纯 C)
  • CMAKE_CXX_STANDARD 推荐设为 17 或 20,避免某些 STL 特性不可用
  • 如果用了 add_library(),记得对应加 target_compile_features(XXX PRIVATE cxx_std_17),否则链接时可能报符号找不到
实际跑通一个最小项目,核心就是四件事:PATH 里有编译器、CMakeLists.txt 声明 C++、build 目录里分两步走(configure + build)、VS Code 里 kit 别选错。其余报错,八成是这四个环节中某一个断了链。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3099

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2658

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

1448

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2439

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3230

2023.08.08

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1517

2023.08.10

windows boot manager
windows boot manager

windows boot manager无法开机的解决方法:1、系统文件损坏,使用Windows安装光盘或USB启动盘进入恢复环境,选择修复计算机,然后选择自动修复;2、引导顺序错误,进入恢复环境,选择命令提示符,输入命令"bootrec /fixboot"和"bootrec /fixmbr",然后重新启动计算机;3、硬件问题,使用硬盘检测工具进行扫描和修复;4、重装操作系统。本专题还提供其他解决

2417

2023.08.28

windows锁屏快捷键
windows锁屏快捷键

windows锁屏快捷键是Windows键+L、Ctrl+Alt+Del、Windows键+D、Windows键+P和Windows键+R。本专题为大家提供windows相关的文章、下载、课程内容,供大家免费下载体验。

4507

2023.08.30

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 入门教程
Conan 2 入门教程

共0课时 | 0人学习

CLion CMake 快速入门教程
CLion CMake 快速入门教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn