推荐长期维护用单元测试框架(如catch2),临时验证用c/c++ single file execution插件;前者需配置测试文件并确保函数可链接,后者无需项目配置直接编译运行单文件。

直接在 CLion 里测单个 C++ 函数,不用写完整项目、不改 CMakeLists.txt,核心就两条路:用单元测试框架(推荐长期维护),或用单文件快速执行(适合临时验证)。选哪条,取决于你手头代码的形态和目的。
用 Google Test / Catch2 写真正的单元测试
如果你的函数已有明确接口(比如 int add(int a, int b)),且未来可能被复用、重构或集成进更大系统,必须走单元测试路线。CLion 原生支持 Google Test、Catch2、Boost.Test 和 Doctest,其中 Catch2 零依赖、单头文件,对新手最友好。
- 新建一个
test_add.cpp,包含#include "catch2/catch.hpp"(需先通过CMakeLists.txt引入 Catch2,或用 vcpkg/conan 安装) - 写测试用例:
TEST_CASE("add returns sum") { REQUIRE(add(2, 3) == 5); REQUIRE(add(-1, 1) == 0); } - 右键测试函数名 →
Run 'add returns sum',CLion 自动识别并运行;失败时错误信息直接标出哪行REQUIRE没过 - 注意:测试文件必须能独立编译,所以被测函数要么定义在头文件中(
inline或模板),要么确保链接时能找到其实现(常见坑:只声明没定义,报undefined reference to 'add')
用 C/C++ Single File Execution 插件快速验证
你只是想马上看看 std::sort 对 vector 的效果,或者调试一个刚写的 parse_json 辅助函数?别建工程,装插件就行。它绕过所有构建配置,直接调用系统编译器跑单个 .cpp 文件。
- 安装插件:
Settings → Plugins → Marketplace搜C/C++ Single File Execution,安装后重启 - 新建
quick_test.cpp,写满main()和你要测的函数调用,例如:int my_func(int x) { return x * 2; } int main() { std::cout - 编辑器左侧会出现绿色三角图标 → 点击即可编译运行;点虫子图标可直接调试(断点照常生效)
- 关键限制:不能跨文件调用(比如
my_func在另一个.cpp里就不行),所有依赖必须塞进这一个文件,或通过#include引入标准库/头文件
直接在源文件里加 main 并运行(最简但有副作用)
某些教学场景或算法题片段,你手头只有一个 utils.cpp,里面全是工具函数,但没 main。这时可以临时加个 main 测试,但要注意后续清理。
- 在
utils.cpp底部追加:#ifdef TEST_UTILS int main() { std::cout - 在 CLion 的运行配置中,给编译器加预处理器定义:
-DTEST_UTILS(路径:Run → Edit Configurations → C/C++ File → Toolchain → Compiler → Other options) - 这样既不影响正式构建(其他地方不定义
TEST_UTILS就不会编译main),又避免污染主逻辑 - 风险:容易忘记删
main或漏掉#ifdef,导致提交代码时编译失败或行为异常
真正麻烦的从来不是“怎么跑起来”,而是函数依赖外部状态(比如全局变量、文件读写、随机数种子)——这种函数很难单独测。优先把它拆成纯输入输出的接口,再套上面任一方法。否则,你花十分钟配好 Catch2,结果发现要 mock 整个 IO 层,那就本末倒置了。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











