必须用shared library方式链接，头文件方式会导致undefined reference错误；需定义boost_test_dyn_link、仅一处定义boost_test_main、正确配置cmakelists.txt并使用boost.test运行配置。
Boost.Test 在 CLion 中必须用 shared library 方式链接
头文件方式（BOOST_TEST_DYN_LINK 未定义 + 直接 #include <boost></boost>）会导致链接失败，报 undefined reference to 'boost::unit_test::ut_detail::auto_test_unit_registrar::auto_test_unit_registrar 类错误。CLion 的 Boost.Test 运行器只识别动态链接的测试可执行文件。
关键点：
-
#define BOOST_TEST_DYN_LINK必须在所有测试源文件最顶部（早于任何#include） -
find_package(Boost REQUIRED COMPONENTS unit_test_framework)中不能加CONFIG或MODULE模式修饰，否则可能找不到库 - 确保
Boost_USE_STATIC_LIBS设为OFF，且系统已安装 Boost 动态库（如 Windows 上是boost_unit_test_framework-vc143-mt-x64-1_82.dll，macOS 是libboost_unit_test_framework.dylib）
CMakeLists.txt 必须显式声明 target_link_libraries
仅靠 find_package 和 include_directories 不足以让 CLion 识别 Boost.Test 可执行目标。CLion 的测试运行器依赖 CMake 构建目标是否正确关联了 Boost 测试库。
正确写法示例（放在子目录如 Boost_tests/CMakeLists.txt 中）：
set(Boost_USE_STATIC_LIBS OFF)
find_package(Boost REQUIRED COMPONENTS unit_test_framework)
<p>add_executable(Boost_Tests_run test1.cpp test2.cpp)
target_include_directories(Boost_Tests_run PRIVATE ${Boost_INCLUDE_DIRS})
target_link_libraries(Boost_Tests_run PRIVATE ${Boost_LIBRARIES})</p><h1>关键：启用 CLion 的 Boost.Test 支持</h1><p>set_property(TARGET Boost_Tests_run PROPERTY IMPORTED_LOCATION ${Boost_LIBRARY_DIRS}/libboost_unit_test_framework.so)</p>
注意：
-
target_link_libraries必须使用PRIVATE或PUBLIC作用域，不能只写${Boost_LIBRARIES} - 如果
${Boost_LIBRARIES}展开为空，说明find_package未定位到库 —— 此时需手动指定BOOST_ROOT或设置CMAKE_PREFIX_PATH - macOS 用户若用
brew install boost，Boost_LIBRARY_DIRS通常为/opt/homebrew/lib（Apple Silicon）或/usr/local/lib
CLion 不会自动识别 main() 入口，必须用 BOOST_TEST_MAIN
Boost.Test 要求只有一个翻译单元定义 BOOST_TEST_MAIN 宏，否则链接时报 multiple definition of 'main'。CLion 的测试运行器依赖这个宏生成的入口函数来启动测试框架。
常见错误写法：
- 在每个
.cpp文件里都写#define BOOST_TEST_MAIN→ 链接失败 - 写了
int main() { return 0; }手动入口 → CLion 测试面板不识别，只能当普通程序运行
正确做法：
- 选一个测试文件（如
test_main.cpp），**仅在此文件第一行**写：#define BOOST_TEST_MAIN - 紧随其后写：
#define BOOST_TEST_DYN_LINK和#include <boost></boost> - 其他测试文件只写
#define BOOST_TEST_DYN_LINK和#include <boost></boost>，不写BOOST_TEST_MAIN
Run Configuration 必须选 Boost.Test 类型，不能用 “Application”
即使编译通过，如果右键测试文件 → Run 出来的还是灰色“Application”配置，那 CLion 就不会解析测试用例、不会显示绿色勾/红色叉图标，也无法跳转到失败断言行。
解决方法：
- 先确保 CMake 重新加载成功（右下角提示 “Project reloaded”）
- 右键测试文件 →
Run 'Boost_Tests_run'（名称来自add_executable），首次运行时 CLion 会自动创建 Boost.Test 类型配置 - 若没自动创建，手动进
Run | Edit Configurations...→+ → Boost.Test→ Target 选你的可执行目标（如Boost_Tests_run） - 检查配置中
Program arguments是否为空；如需运行特定测试套件，填入--run_test=TwoTwoFour_suite
最容易被忽略的一点：Boost.Test 配置里的 Working directory 默认是项目根目录，但如果你的测试读取了相对路径资源（比如 data/input.txt），得手动改成 $ProjectFileDir$/Boost_tests 这类实际路径，否则文件打开失败不报错，只默默跳过测试。
