clion运行按钮变灰说明cmake配置失败，主因是cmakelists.txt未包含main.cpp、工具链未设置或不可用、cmakelists.txt不在项目根目录、或配置未成功加载；需检查cmake工具窗口日志及生成目录验证。
CLion新手学CMake，不是去背命令手册，而是先搞懂“CLion里哪些按钮变灰了、为什么变灰、点哪里能让它亮起来”——这三件事理清了，CMake就入门了一半。
CLion里那个灰色的运行按钮，到底在等什么？
新建项目后，main.cpp旁边那个绿色三角形是灰色的，说明CLion还没拿到可执行目标。它不关心你写了多少行代码，只认CMakeLists.txt里有没有add_executable()，以及这个目标是否被正确解析。
- 检查
CMakeLists.txt最底部是否有类似add_executable(myapp main.cpp)的语句；没有就手动加一行，注意名字要和项目名或你想生成的可执行文件名一致 - CLion不会自动重载修改后的
CMakeLists.txt，改完必须点右上角的Reload CMake project（小循环图标）或按Ctrl+Shift+O - 如果点了重载但状态栏仍显示“Configuring…”卡住，大概率是
cmake_minimum_required(VERSION ...)写的版本太高，而CLion捆绑的CMake版本不够——查一下Help → About里显示的CMake版本，把要求版本调低到3.20或3.25
为什么include头文件总报错，但文件明明就在目录里？
CLion不扫描文件系统，它只读CMakeLists.txt里声明的路径。你看到的文件结构只是“磁盘快照”，不是“构建视图”。
- 头文件放在
include/目录下，就得在CMakeLists.txt里加include_directories(include)（相对路径从项目根开始算） - 如果用
target_include_directories(myapp PRIVATE include)更好——它作用于具体目标，避免污染全局，且支持PRIVATE/PUBLIC作用域控制 - 别用
file(GLOB_RECURSE SOURCES "src/*.cpp")自动收集源文件：CLion无法感知这种动态路径，新增.cpp后不会自动加入构建，必须手动重载，还容易漏掉新文件
怎么快速验证一段C++代码，又不想建完整项目？
真没必要为一个main.cpp折腾CMake。CLion官方插件C/C++ Single File Execution就是干这事的。
- 安装路径：
Settings → Plugins → Marketplace搜Single File Execution，重启CLion - 启用后，打开任意
.cpp文件，右键菜单会出现Run 'xxx.cpp'选项，点它会自动生成临时CMake配置并运行 - 注意：它默认用当前工具链编译，不读你项目里的
CMakeLists.txt；适合验证语法、算法逻辑，不适合测试链接第三方库的代码 - 插件生成的临时构建目录在
cmake-build-single-file，不用管，关掉文件后自动清理
真正卡住新手的，从来不是add_library()怎么写，而是不知道CLion哪一步没“看见”你的改动。每次改完CMakeLists.txt，记得按Ctrl+Shift+O；每次加了新.h，先想清楚路径有没有告诉CMake；每次按钮变灰，第一反应不是重装软件，而是看右下角CMake状态栏有没有报错信息——这些细节比记住所有命令重要得多。
