find_package(Boost REQUIRED COMPONENTS system) 必须显式指定并链接 Boost::system，因Boost.Asio虽为头文件库，但timer、DNS、SSL等特性依赖boost_system运行时库，否则链接报undefined reference；vcpkg用户还需设置CMAKE_TOOLCHAIN_FILE。
直接用 find_package(Boost REQUIRED COMPONENTS system) 通常会失败，因为 Boost.Asio 是头文件库（header-only），但依赖 boost_system 等动态/静态库；CMake 默认不自动链接这些运行时依赖。
为什么 find_package(Boost) 不够用
Boost.Asio 大部分接口在 boost/asio.hpp 中定义，编译期就能展开，看似“不用链接”——但一旦用到 deadline_timer、steady_timer、DNS 解析、SSL 或跨平台线程调度等特性，就会隐式调用 boost_system（甚至 boost_thread）。CMake 找到头文件后，若没显式链接 Boost::system，链接阶段大概率报 undefined reference to 'boost::system::generic_category()' 这类错误。
- Ubuntu/Debian 下装
libboost-dev或libboost-system-dev后，find_package(Boost REQUIRED COMPONENTS system)才能定位到库 - Windows + vcpkg 场景下，
find_package(Boost REQUIRED)可能成功，但必须配合-DCMAKE_TOOLCHAIN_FILE=.../vcpkg.cmake，否则target_link_libraries仍找不到boost_system - macOS Homebrew 安装的 boost 默认不启用静态链接，需确认
Boost_SYSTEM_LIBRARY指向的是.dylib还是.a，否则可能运行时报 dyld 错误
target_link_libraries 必须显式加 Boost::system
即使你只写了 #include <boost/asio.hpp> 并只用了 io_context 和 tcp::socket，只要构造了 steady_timer 或调用了 resolve()，就绕不开 boost_system。CMakeLists.txt 中必须写：
find_package(Boost REQUIRED COMPONENTS system) target_link_libraries(my_app PRIVATE Boost::system)
注意：Boost::system 是 CMake 导出的 imported target，不是字符串 "boost_system"；写成 boost_system 会导致链接失败或静默忽略。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
- 如果项目还用到了 SSL，得额外加
find_package(Boost REQUIRED COMPONENTS system ssl)和Boost::ssl - 使用
asio::spawn协程时，需要Boost::context和Boost::fiber（取决于 Boost 版本），不能只靠system - 某些旧版 Boost（如 1.65 之前）没有导出
Boost::systemtarget，此时要退回到target_link_libraries(my_app PRIVATE ${Boost_SYSTEM_LIBRARY})
vcpkg 用户必须设 CMAKE_TOOLCHAIN_FILE
vcpkg 安装 boost-asio:x64-windows 后，它实际只提供头文件和 boost_system 库，但 CMake 默认不会去 C:/vcpkg/installed/x64-windows 查找。不设工具链，find_package 就算找到 Boost，链接时也会提示 cannot open input file 'libboost_system-vc143-mt-x64-1_85.lib'。
- 命令行构建：加
-DCMAKE_TOOLCHAIN_FILE=C:/vcpkg/scripts/buildsystems/vcpkg.cmake - Visual Studio + CMake 集成：在项目设置 → CMake → 工具链文件中填入该路径
- Clion：在 Settings → Build → CMake → Toolchain File 中指定
- 漏掉这步，
find_package(asio2 REQUIRED)这类封装库也可能失败，因为 asio2 内部仍依赖 Boost 的底层库
Asio2 用户可跳过 Boost 配置，但仍有隐含约束
Asio2 封装了 Asio 并做了大量简化，find_package(asio2 REQUIRED) 看似省事，但它内部仍通过 find_dependency(Boost) 拉取依赖。如果你用 vcpkg 装了 asio2，它会自动带入对应版本的 Boost；但若手动编译 asio2，则必须确保系统 Boost 版本 ≥ 1.70（asio2 用到了 asio::awaitable）。
- asio2 的
target_link_libraries(${PROJECT_NAME} PRIVATE asio2::asio2)已包含对Boost::system的传递依赖，你无需再写一遍 - 但若你在代码里混用原始
boost::asio::steady_timer和 asio2 的asio2::timer，就得同时满足两套链接规则，容易冲突 - asio2 默认启用 C++20 协程，若编译器不支持（如 MSVC 19.29 以下），需关掉
ASIO2_USE_COROUTINE宏
最易被忽略的一点：Boost.Asio 的头文件路径和库路径由不同机制控制——find_package 控制头文件搜索，target_link_libraries 控制链接，而 vcpkg 工具链控制两者是否一致。三者缺一不可，且顺序不能颠倒：先设工具链，再 find_package，最后 target_link_libraries。
