必须设置cmake_system_name才算真正进入交叉编译模式；它决定cmake_crosscompiling是否为true，是整个交叉编译流程的开关，且必须在project()前设置，常见取值有linux、windows、generic。
必须设置 CMAKE_SYSTEM_NAME 才算真正进入交叉编译模式
只改 CMAKE_C_COMPILER 和 CMAKE_CXX_COMPILER 是不够的。CMake 判断是否交叉编译，核心依据是 CMAKE_SYSTEM_NAME 是否被显式设置。没设它，CMAKE_CROSSCOMPILING 永远是 FALSE，后续所有跨平台逻辑（比如 find_package 的路径行为、externalproject_add 的编译器继承）都会走错分支。
常见取值：Linux（目标跑 Linux）、Windows（MinGW 交叉）、Generic（裸机/无 OS 嵌入式）。设成 Linux 后，CMake 自动把 CMAKE_CROSSCOMPILING 设为 TRUE，这是整个流程的开关。
-
CMAKE_SYSTEM_NAME必须在project()之前设置，否则无效 - 设成
Linux不代表目标一定是 x86_64；它只声明操作系统层，和架构无关 - 如果目标是裸机（如 STM32），用
Generic更准确，避免 CMake 尝试找/usr/include这类宿主机路径
CMAKE_SYSTEM_PROCESSOR 决定架构识别是否正确
这个变量不参与编译器调用，但影响几乎所有依赖架构的判断逻辑：比如 target_compile_options 中的 arm 或 aarch64 条件、第三方库对 ARM 宏的检测、甚至 find_library 在 CMAKE_FIND_ROOT_PATH 下的子目录匹配。
典型值：arm（32 位 ARM）、aarch64（64 位 ARM）、x86_64（极少用于交叉，但某些 Windows-on-ARM 场景会用）、rv64（RISC-V 64 位）。它和 CMAKE_C_COMPILER 名称里的架构部分应一致，否则可能触发隐式不兼容。
- 不设
CMAKE_SYSTEM_PROCESSOR时，CMake 默认用宿主机架构（如x86_64），导致if(ARM)这类条件判断失败 - 设成
arm但用了aarch64-none-linux-gnu-gcc，某些库的构建脚本可能因架构字符串不匹配而跳过优化或启用错误指令集 - 对于 LuckFox Pico 这类 uClibc 平台，
CMAKE_SYSTEM_PROCESSOR设为arm，而非armv7或armv8—— CMake 不解析 CPU 微架构，只认通用名
工具链文件比硬编码进 CMakeLists.txt 更可靠
把 set(CMAKE_C_COMPILER ...) 直接写在项目 CMakeLists.txt 里，看似简单，但会导致两个问题：一是 externalproject_add 子项目无法继承这些设置；二是多人协作时，不同人工具链路径不同，容易提交错误路径到仓库。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
正确做法是单独写一个 toolchain.cmake 文件，里面集中定义所有交叉相关变量，然后通过 -DCMAKE_TOOLCHAIN_FILE=xxx 传给 cmake 命令。这样既解耦，又可复用。
- 工具链文件中必须包含
set(CMAKE_SYSTEM_NAME ...)和set(CMAKE_SYSTEM_PROCESSOR ...)，否则无效 -
CMAKE_SYSROOT和CMAKE_FIND_ROOT_PATH要指向工具链自带的 sysroot（含usr/include和usr/lib），不是工具链安装根目录 -
CMAKE_FIND_ROOT_PATH_MODE_PROGRAM设为NEVER，避免 CMake 错误地在目标 sysroot 里找pkg-config这类宿主机工具
CMAKE_FIND_ROOT_PATH_MODE_* 控制头文件和库的查找范围
默认情况下，CMake 的 find_path、find_library、find_program 会同时搜索宿主机系统路径和你指定的 CMAKE_FIND_ROOT_PATH。这对交叉编译是危险的——可能链接到宿主机的 libssl.so 而非目标平台的。
三个关键变量必须显式设置：
-
CMAKE_FIND_ROOT_PATH_MODE_PROGRAM：设为NEVER，确保只在宿主机找可执行程序（如cmake自身需要的git、pkg-config） -
CMAKE_FIND_ROOT_PATH_MODE_LIBRARY：设为ONLY，强制只在CMAKE_FIND_ROOT_PATH下找库（如libopencv_core.so） -
CMAKE_FIND_ROOT_PATH_MODE_INCLUDE：设为ONLY，强制只在CMAKE_FIND_ROOT_PATH下找头文件（如opencv2/opencv.hpp）
漏设任何一个，都可能导致构建产物在目标板上运行时报 undefined symbol 或 cannot open shared object file。
CMAKE_SYSTEM_NAME 和 CMAKE_SYSTEM_PROCESSOR 没设，或者 CMAKE_FIND_ROOT_PATH_MODE_* 保持默认值。这两个地方一错，整个构建链就从“交叉”退化成“假装交叉”，生成的二进制很可能在目标板上根本起不来。
